220 lines
8.5 KiB
C
220 lines
8.5 KiB
C
//*********************************************************************
|
|
//* 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_
|