//******************************************************************* // // Copyright (c) 1996-1998 Microsoft Corporation // // *** N O T F O R E X T E R N A L R E L E A S E ******* // This header file is not intended for distribution outside Microsoft. // // FILE: INETCFG.H // // PURPOSE: Contains API's exported from inetcfg.dll and structures // required by those functions. // Note: Definitions in this header file require RAS.H. // //******************************************************************* #ifndef _INETCFG_H_ #define _INETCFG_H_ #ifndef UNLEN #include #endif // Generic HRESULT error code #define ERROR_INETCFG_UNKNOWN 0x20000000L #define MAX_EMAIL_NAME 64 #define MAX_EMAIL_ADDRESS 128 #define MAX_LOGON_NAME UNLEN #define MAX_LOGON_PASSWORD PWLEN #define MAX_SERVER_NAME 64 // max length of DNS name per RFC 1035 +1 // Flags for dwfOptions // install Internet mail #define INETCFG_INSTALLMAIL 0x00000001 // Invoke InstallModem wizard if NO MODEM IS INSTALLED #define INETCFG_INSTALLMODEM 0x00000002 // install RNA (if needed) #define INETCFG_INSTALLRNA 0x00000004 // install TCP (if needed) #define INETCFG_INSTALLTCP 0x00000008 // connecting with LAN (vs modem) #define INETCFG_CONNECTOVERLAN 0x00000010 // Set the phone book entry for autodial #define INETCFG_SETASAUTODIAL 0x00000020 // Overwrite the phone book entry if it exists // Note: if this flag is not set, and the entry exists, a unique name will // be created for the entry. #define INETCFG_OVERWRITEENTRY 0x00000040 // Do not show the dialog that tells the user that files are about to be installed, // with OK/Cancel buttons. #define INETCFG_SUPPRESSINSTALLUI 0x00000080 // Check if TCP/IP file sharing is turned on, and warn user to turn it off. // Reboot is required if the user turns it off. //#define INETCFG_WARNIFSHARINGBOUND 0x00000100 // Check if TCP/IP file sharing is turned on, and force user to turn it off. // If user does not want to turn it off, return will be ERROR_CANCELLED // Reboot is required if the user turns it off. //#define INETCFG_REMOVEIFSHARINGBOUND 0x00000200 // Indicates that this is a temporary phone book entry // In Win3.1 an icon will not be created #define INETCFG_TEMPPHONEBOOKENTRY 0x00000400 // Show the busy dialog while checking system configuration //#define INETCFG_SHOWBUSYANIMATION 0x00000800 // // Chrisk 5/8/97 // Note: the next three switches are only valid for InetNeedSystemComponents // Check if LAN adapter is installed and bound to TCP // #define INETCFG_INSTALLLAN 0x00001000 // // Check if DIALUP adapter is installed and bound to TCP // #define INETCFG_INSTALLDIALUP 0x00002000 // // Check to see if TCP is installed requardless of binding // #define INETCFG_INSTALLTCPONLY 0x00004000 #ifdef __cplusplus extern "C" { #endif // __cplusplus // constants for INETCLIENTINFO.dwFlags #define INETC_LOGONMAIL 0x00000001 #define INETC_LOGONNEWS 0x00000002 #define INETC_LOGONDIRSERV 0x00000004 // Struct INETCLIENTINFO // // This structure is used when getting and setting the internet // client parameters // // The members are as follows: // // dwSize // size of this structure, for future versioning // this member should be set before passing the structure to the DLL // dwFlags // miscellaneous flags // see definitions above // szEMailName // user's internet email name // szEMailAddress // user's internet email address // ***Note: the following three fields are outdated, and should only be used by old legacy code. // *** new code should use szIncomingMail* and iIncomingProtocol fields. // szPOPLogonName // user's internet mail server logon name // szPOPLogonPassword // user's internet mail server logon password // szPOPServer // user's internet mail POP3 server // szSMTPServer // user's internet mail SMTP server // szNNTPLogonName // user's news server logon name // szNNTPLogonPassword // user's news server logon password // szNNTPServer // user's news server // ** End of original 1.0 structure. // ??/??/96 ValdonB // szNNTPName // user's friendly name to include in NNTP posts.(?? Valdon?) // szNNTPAddress // user's reply-to email address for NNTP posts.(?? Valdon?) // 11/23/96 jmazner Normandy #8504 // iIncomingProtocol // user's choice of POP3 or IMAP4 protocol for incoming mail // Holds the enum values defined in ACCTTYPE from imact.h// // szIncomingMailLogonName // user's internet mail server logon name // szIncomingMailLogonPassword // user's internet mail server logon password // szIncomingMailServer // user's internet mail POP3 server // 12/15/96 jmazner // fMailLogonSPA // Use Sicily/SPA/DPA for the incoming mail server // fNewsLogonSPA // Use Sicily/SPA/DPA for the news server // 2/4/96 jmazner -- LDAP functionality // szLDAPLogonName // szLDAPLogonPassword // szLDAPServer // fLDAPLogonSPA // fLDAPResolve typedef struct tagINETCLIENTINFO { DWORD dwSize; DWORD dwFlags; CHAR szEMailName[MAX_EMAIL_NAME + 1]; CHAR szEMailAddress[MAX_EMAIL_ADDRESS + 1]; CHAR szPOPLogonName[MAX_LOGON_NAME + 1]; CHAR szPOPLogonPassword[MAX_LOGON_PASSWORD + 1]; CHAR szPOPServer[MAX_SERVER_NAME + 1]; CHAR szSMTPServer[MAX_SERVER_NAME + 1]; CHAR szNNTPLogonName[MAX_LOGON_NAME + 1]; CHAR szNNTPLogonPassword[MAX_LOGON_PASSWORD + 1]; CHAR szNNTPServer[MAX_SERVER_NAME + 1]; // end of version 1.0 structure; // extended 1.1 structure includes the following fields: CHAR szNNTPName[MAX_EMAIL_NAME + 1]; CHAR szNNTPAddress[MAX_EMAIL_ADDRESS + 1]; int iIncomingProtocol; CHAR szIncomingMailLogonName[MAX_LOGON_NAME + 1]; CHAR szIncomingMailLogonPassword[MAX_LOGON_PASSWORD + 1]; CHAR szIncomingMailServer[MAX_SERVER_NAME + 1]; BOOL fMailLogonSPA; BOOL fNewsLogonSPA; CHAR szLDAPLogonName[MAX_LOGON_NAME + 1]; CHAR szLDAPLogonPassword[MAX_LOGON_PASSWORD + 1]; CHAR szLDAPServer[MAX_SERVER_NAME + 1]; BOOL fLDAPLogonSPA; BOOL fLDAPResolve; } INETCLIENTINFO, *PINETCLIENTINFO, FAR *LPINETCLIENTINFO; // Function prototypes //******************************************************************* // // FUNCTION: InetGetClientInfo // // PURPOSE: This function will get the internet client params // from the registry // // PARAMETERS: lpClientInfo - on return, this structure will contain // the internet client params as set in the registry. // lpszProfileName - Name of client info profile to // retrieve. If this is NULL, the default profile is used. // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetGetClientInfo( LPCSTR lpszProfileName, LPINETCLIENTINFO lpClientInfo); //******************************************************************* // // FUNCTION: InetSetClientInfo // // PURPOSE: This function will set the internet client params // // PARAMETERS: lpClientInfo - pointer to struct with info to set // in the registry. // lpszProfileName - Name of client info profile to // modify. If this is NULL, the default profile is used. // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetSetClientInfo( LPCSTR lpszProfileName, LPINETCLIENTINFO lpClientInfo); //******************************************************************* // // FUNCTION: InetConfigSystem // // PURPOSE: This function will install files that are needed // for internet access (such as TCP/IP and RNA) based // the state of the options flags. // // PARAMETERS: hwndParent - window handle of calling application. This // handle will be used as the parent for any dialogs that // are required for error messages or the "installing files" // dialog. // dwfOptions - a combination of INETCFG_ flags that controls // the installation and configuration as follows: // // INETCFG_INSTALLMAIL - install Internet mail // INETCFG_INSTALLMODEM - Invoke InstallModem wizard if NO // MODEM IS INSTALLED. // INETCFG_INSTALLRNA - install RNA (if needed) // INETCFG_INSTALLTCP - install TCP/IP (if needed) // INETCFG_CONNECTOVERLAN - connecting with LAN (vs modem) // INETCFG_WARNIFSHARINGBOUND - Check if TCP/IP file sharing is // turned on, and warn user to turn // it off. Reboot is required if // the user turns it off. // INETCFG_REMOVEIFSHARINGBOUND - Check if TCP/IP file sharing is // turned on, and force user to turn // it off. If user does not want to // turn it off, return will be // ERROR_CANCELLED. Reboot is // required if the user turns it off. // // lpfNeedsRestart - if non-NULL, then on return, this will be // TRUE if windows must be restarted to complete the installation. // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetConfigSystem( HWND hwndParent, DWORD dwfOptions, LPBOOL lpfNeedsRestart); //******************************************************************* // // FUNCTION: InetConfigSystemFromPath // // PURPOSE: This function will install files that are needed // for internet access (such as TCP/IP and RNA) based // the state of the options flags and from the given [ath. // // PARAMETERS: hwndParent - window handle of calling application. This // handle will be used as the parent for any dialogs that // are required for error messages or the "installing files" // dialog. // dwfOptions - a combination of INETCFG_ flags that controls // the installation and configuration as follows: // // INETCFG_INSTALLMAIL - install Internet mail // INETCFG_INSTALLMODEM - Invoke InstallModem wizard if NO // MODEM IS INSTALLED. // INETCFG_INSTALLRNA - install RNA (if needed) // INETCFG_INSTALLTCP - install TCP/IP (if needed) // INETCFG_CONNECTOVERLAN - connecting with LAN (vs modem) // INETCFG_WARNIFSHARINGBOUND - Check if TCP/IP file sharing is // turned on, and warn user to turn // it off. Reboot is required if // the user turns it off. // INETCFG_REMOVEIFSHARINGBOUND - Check if TCP/IP file sharing is // turned on, and force user to turn // it off. If user does not want to // turn it off, return will be // ERROR_CANCELLED. Reboot is // required if the user turns it off. // // lpfNeedsRestart - if non-NULL, then on return, this will be // TRUE if windows must be restarted to complete the installation. // lpszSourcePath - full path of location of files to install. If // this is NULL, default path is used. // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetConfigSystemFromPath( HWND hwndParent, DWORD dwfOptions, LPBOOL lpfNeedsRestart, LPCSTR lpszSourcePath); //******************************************************************* // // FUNCTION: InetConfigClient // // PURPOSE: This function requires a valid phone book entry name // (unless it is being used just to set the client info). // If lpRasEntry points to a valid RASENTRY struct, the phone // book entry will be created (or updated if it already exists) // with the data in the struct. // If username and password are given, these // will be set as the dial params for the phone book entry. // If a client info struct is given, that data will be set. // Any files (ie TCP and RNA) that are needed will be // installed by calling InetConfigSystem(). // This function will also perform verification on the device // specified in the RASENTRY struct. If no device is specified, // the user will be prompted to install one if there are none // installed, or they will be prompted to choose one if there // is more than one installed. // // PARAMETERS: hwndParent - window handle of calling application. This // handle will be used as the parent for any dialogs that // are required for error messages or the "installing files" // dialog. // lpszPhonebook - name of phone book to store the entry in // lpszEntryName - name of phone book entry to be // created or modified // lpRasEntry - specifies a RASENTRY struct that contains // the phone book entry data for the entry lpszEntryName // lpszUsername - username to associate with the phone book entry // lpszPassword - password to associate with the phone book entry // lpszProfileName - Name of client info profile to // retrieve. If this is NULL, the default profile is used. // lpINetClientInfo - client information // dwfOptions - a combination of INETCFG_ flags that controls // the installation and configuration as follows: // // INETCFG_INSTALLMAIL - install Internet mail // INETCFG_INSTALLMODEM - Invoke InstallModem wizard if NO // MODEM IS INSTALLED. Note that if // no modem is installed and this flag // is not set, the function will fail // INETCFG_INSTALLRNA - install RNA (if needed) // INETCFG_INSTALLTCP - install TCP/IP (if needed) // INETCFG_CONNECTOVERLAN - connecting with LAN (vs modem) // INETCFG_SETASAUTODIAL - Set the phone book entry for autodial // INETCFG_OVERWRITEENTRY - Overwrite the phone book entry if it // exists. Note: if this flag is not // set, and the entry exists, a unique // name will be created for the entry. // INETCFG_WARNIFSHARINGBOUND - Check if TCP/IP file sharing is // turned on, and warn user to turn // it off. Reboot is required if // the user turns it off. // INETCFG_REMOVEIFSHARINGBOUND - Check if TCP/IP file sharing is // turned on, and force user to turn // it off. If user does not want to // turn it off, return will be // ERROR_CANCELLED. Reboot is // required if the user turns it off. // // lpfNeedsRestart - if non-NULL, then on return, this will be // TRUE if windows must be restarted to complete the installation. // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetConfigClient( HWND hwndParent, LPCSTR lpszPhonebook, LPCSTR lpszEntryName, LPRASENTRY lpRasEntry, LPCSTR lpszUsername, LPCSTR lpszPassword, LPCSTR lpszProfileName, LPINETCLIENTINFO lpINetClientInfo, DWORD dwfOptions, LPBOOL lpfNeedsRestart); //******************************************************************* // // FUNCTION: InetGetAutodial // // PURPOSE: This function will get the autodial settings from the registry. // // PARAMETERS: lpfEnable - on return, this will be TRUE if autodial // is enabled // lpszEntryName - on return, this buffer will contain the // name of the phone book entry that is set for autodial // cbEntryNameSize - size of buffer for phone book entry name // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetGetAutodial( LPBOOL lpfEnable, LPSTR lpszEntryName, DWORD cbEntryNameSize); //******************************************************************* // // FUNCTION: InetSetAutodial // // PURPOSE: This function will set the autodial settings in the registry. // // PARAMETERS: fEnable - If set to TRUE, autodial will be enabled. // If set to FALSE, autodial will be disabled. // lpszEntryName - name of the phone book entry to set // for autodial. If this is "", the // entry is cleared. If NULL, it is not changed. // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetSetAutodial( BOOL fEnable, LPCSTR lpszEntryName); //******************************************************************* // // FUNCTION: InetSetProxy // // PURPOSE: This function will set the proxy settings in the registry. // // PARAMETERS: fEnable - If set to TRUE, proxy will be enabled. // If set to FALSE, proxy will be disabled. // lpszServer - name of the proxy server. If this is "", the // entry is cleared. If NULL, it is not changed. // lpszOverride - proxy override. If this is "", the // entry is cleared. If NULL, it is not changed. // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetSetProxy( BOOL fEnable, LPCSTR lpszServer, LPCSTR lpszOverride); //******************************************************************* // // FUNCTION: InetGetProxy // // PURPOSE: This function will get the proxy settings from the registry. // // PARAMETERS: lpfEnable - on return, this will be TRUE if proxy // is enabled // lpszServer - on return, this buffer will contain the // name of the proxy server // cbServer - size of buffer for proxy server name // lpszOverride - on return, this buffer will contain the // name of the proxy server // cbOverride - size of buffer for proxy override // // RETURNS: HRESULT code, ERROR_SUCCESS if no errors occurred // //******************************************************************* HRESULT WINAPI InetGetProxy( LPBOOL lpfEnable, LPSTR lpszServer, DWORD cbServer, LPSTR lpszOverride, DWORD cbszOverride); //******************************************************************* // // FUNCTION: InetStartServices // // PURPOSE: This function guarentees that RAS services are running // // PARAMETERS: none // // RETURNS ERROR_SUCCESS - if the services are enabled and running // //******************************************************************* HRESULT WINAPI InetStartServices(); //******************************************************************* // // Function: IsSmartStart // // Synopsis: This function will determine if the ICW should be run. The // decision is made based on the current state of the user's machine. // // Arguments: none // // Returns: TRUE - run ICW; FALSE - quit now // // History: 5/8/97 ChrisK Created // //******************************************************************* DWORD WINAPI IsSmartStart(); #ifdef __cplusplus } #endif // __cplusplus #endif //_INETCFG_H_#