//*********************************************************************
//*                  Microsoft Windows                               **
//*            Copyright(c) Microsoft Corp., 1995                    **
//*********************************************************************

//
// INETAPI.H -  APIs for system configuration for Internet and phone number
//              setting
//

//  HISTORY:
//  
//  3/3/95  jeremys     Created.
//  96/03/21  markdu  Use private string sizes (MSN_) for PHONENUM since the
//            RAS ones (RAS_) change depending on platform, but MSN does not
//            expect this so the structure sizes won't match on existing code.
//

#ifndef _INETAPI_H_
#define _INETAPI_H_

#ifndef _RNAP_H_
// (copied from RNA header file)

#define MSN_MaxAreaCode     10
#define MSN_MaxLocal        36
#define MSN_MaxExtension    5

typedef struct tagPHONENUMA {
    DWORD dwCountryID;
    DWORD dwCountryCode;
    CHAR  szAreaCode[MSN_MaxAreaCode+1];
    CHAR  szLocal[MSN_MaxLocal+1];
    CHAR  szExtension[MSN_MaxExtension+1];
} PHONENUMA, FAR * LPPHONENUMA;

typedef struct tagPHONENUMW {
    DWORD dwCountryID;
    DWORD dwCountryCode;
    WCHAR szAreaCode[MSN_MaxAreaCode+1];
    WCHAR szLocal[MSN_MaxLocal+1];
    WCHAR szExtension[MSN_MaxExtension+1];
} PHONENUMW, FAR * LPPHONENUMW;

#ifdef UNICODE
#define PHONENUM     PHONENUMW
#define LPPHONENUM   LPPHONENUMW
#else
#define PHONENUM     PHONENUMA
#define LPPHONENUM   LPPHONENUMA
#endif

#endif // ifndef _RNAP_H_

// input flags for APIs
#define ICIF_NOCONFIGURE    0x0001  // for SetInternetPhoneNumber, see comments below
#define ICIF_DONTSETASINTERNETENTRY 0x0002  // if set, phone number will be updated
                            // but this connectoid will not be set as the internet connectoid
#define ICIF_NODNSCHECK     0x0004  // if set, won't check and warn if static DNS is set

// output flags for APIs
#define ICOF_NEEDREBOOT     0x0001  // indicates that caller must restart system


// structures used to contain API parameters

typedef struct tagINTERNET_CONFIGA
{
    DWORD cbSize;           // size of this structure in bytes
    HWND hwndParent;        // parent window handle

    LPCSTR pszModemName;    // name of modem to use
    LPCSTR pszUserName;     // user name for RNA connectoid (ignored if NULL)
    LPCSTR pszPassword;     // password for RNA connectoid (ignored if NULL)

    PHONENUMA PhoneNum;     // phone number to use
    LPCSTR pszEntryName;    // title to use for RNA connectoid (default name
                            // used if NULL)

    PHONENUMA PhoneNum2;    // backup phone number to use
    LPCSTR pszEntryName2;   // title to use for RNA connectoid (default name
                            // used if NULL)


    LPCSTR pszDNSServer;    // points to string w/IP address (e.g. "108.9.107.4");
                            // (ignored if NULL)
    LPCSTR pszDNSServer2;   // points to string w/IP address(e.g. "108.9.107.4");
                            // (ignored if NULL)

    LPCSTR pszAutodialDllName;  // optional: name of autodial dll to use (ignored if NULL)
    LPCSTR pszAutodialFcnName;  // optional: name of function in autodiall dll to use (ignored if NULL)

    DWORD dwInputFlags;     // at entry, some combination of ICIF_ flags
    DWORD dwOutputFlags;    // at return, set to some combination of ICOF_ flags

} INTERNET_CONFIGA, FAR * LPINTERNET_CONFIGA;

typedef struct tagINTERNET_CONFIGW
{
    DWORD cbSize;           // size of this structure in bytes
    HWND hwndParent;        // parent window handle

    LPCWSTR pszModemName;   // name of modem to use
    LPCWSTR pszUserName;    // user name for RNA connectoid (ignored if NULL)
    LPCWSTR pszPassword;    // password for RNA connectoid (ignored if NULL)

    PHONENUMW PhoneNum;     // phone number to use
    LPCWSTR pszEntryName;   // title to use for RNA connectoid (default name
                            // used if NULL)

    PHONENUMW PhoneNum2;    // backup phone number to use
    LPCWSTR pszEntryName2;  // title to use for RNA connectoid (default name
                            // used if NULL)


    LPCWSTR pszDNSServer;   // points to string w/IP address (e.g. "108.9.107.4");
                            // (ignored if NULL)
    LPCWSTR pszDNSServer2;  // points to string w/IP address(e.g. "108.9.107.4");
                            // (ignored if NULL)

    LPCWSTR pszAutodialDllName;  // optional: name of autodial dll to use (ignored if NULL)
    LPCWSTR pszAutodialFcnName;  // optional: name of function in autodiall dll to use (ignored if NULL)

    DWORD dwInputFlags;     // at entry, some combination of ICIF_ flags
    DWORD dwOutputFlags;    // at return, set to some combination of ICOF_ flags

} INTERNET_CONFIGW, FAR * LPINTERNET_CONFIGW;

#ifdef UNICODE
typedef INTERNET_CONFIGW    INTERNET_CONFIG;
typedef LPINTERNET_CONFIGW  LPINTERNET_CONFIG;
#else
typedef INTERNET_CONFIGA    INTERNET_CONFIG;
typedef LPINTERNET_CONFIGA  LPINTERNET_CONFIG;
#endif
 
// function prototypes


/*******************************************************************

    NAME:       ConfigureSystemForInternet

    SYNOPSIS:   Performs all necessary configuration to set system up
                to use Internet.

    ENTRY:      lpInternetConfig - pointer to structure with configuration
                information.

    EXIT:       TRUE if successful, or FALSE if fails.  Displays its
                own error message upon failure.

                If the output flag ICOF_NEEDREBOOT is set, the caller
                must restart the system before continuing.

    NOTES:      Will install TCP/IP, RNA, PPPMAC as necessary; will
                create or modify an Internet RNA connectoid.

                This API displays error messages itself rather than
                passing back an error code because there is a wide range of
                possible error codes from different families, it is difficult
                for the caller to obtain text for all of them.
                
********************************************************************/
extern "C" BOOL WINAPI ConfigureSystemForInternetA(LPINTERNET_CONFIGA lpInternetConfig);
extern "C" BOOL WINAPI ConfigureSystemForInternetW(LPINTERNET_CONFIGW lpInternetConfig);

#ifdef UNICODE
#define ConfigureSystemForInternet ConfigureSystemForInternetW
#else
#define ConfigureSystemForInternet ConfigureSystemForInternetA
#endif


/*******************************************************************

    NAME:       SetInternetPhoneNumber

    SYNOPSIS:   Sets the phone number used to auto-dial to the Internet.

                If the system is not fully configured when this API is called,
                this API will do the configuration after checking with the user.
                (This step is included for extra robustness, in case the user has
                removed something since the system was configured.)
    
    ENTRY:      lpPhonenumConfig - pointer to structure with configuration
                information.

                If the input flag ICIF_NOCONFIGURE is set, then if the system
                is not already configured properly, this API will display an
                error message and return FALSE.  (Otherwise this API will
                ask the user if it's OK to configure the system, and do it.)

    EXIT:       TRUE if successful, or FALSE if fails.  Displays its
                own error message upon failure.

                If the output flag ICOF_NEEDREBOOT is set, the caller
                must restart the system before continuing.  (

    NOTES:      Will create a new connectoid if a connectoid for the internet
                does not exist yet, otherwise modifies existing internet
                connectoid.

                This API displays error messages itself rather than
                passing back an error code because there is a wide range of
                possible error codes from different families, it is difficult
                for the caller to obtain text for all of them.
                
********************************************************************/
extern "C" BOOL WINAPI SetInternetPhoneNumberA(LPINTERNET_CONFIGA lpInternetConfig);
extern "C" BOOL WINAPI SetInternetPhoneNumberW(LPINTERNET_CONFIGW lpInternetConfig);

#ifdef UNICODE
#define SetInternetPhoneNumber  SetInternetPhoneNumberW
#else
#define SetInternetPhoneNumber  SetInternetPhoneNumberA
#endif

#endif // _INETAPI_H_