/*++ Copyright (c) 1995-1999 Microsoft Corporation Module Name: wininet.h Abstract: Contains manifests, macros, types and prototypes for Microsoft Windows Internet Extensions --*/ #if !defined(_WININET_) #include #define _WININET_ /* * Set up Structure Packing to be 4 bytes * for all wininet structures */ #if defined(_WIN64) #include #else #include #endif #if defined(__cplusplus) extern "C" { #endif #if !defined(_WINX32_) #define INTERNETAPI EXTERN_C DECLSPEC_IMPORT HRESULT STDAPICALLTYPE #define INTERNETAPI_(type) EXTERN_C DECLSPEC_IMPORT type STDAPICALLTYPE #define URLCACHEAPI EXTERN_C DECLSPEC_IMPORT HRESULT STDAPICALLTYPE #define URLCACHEAPI_(type) EXTERN_C DECLSPEC_IMPORT type STDAPICALLTYPE #else #define INTERNETAPI EXTERN_C HRESULT STDAPICALLTYPE #define INTERNETAPI_(type) EXTERN_C type STDAPICALLTYPE #define URLCACHEAPI EXTERN_C HRESULT STDAPICALLTYPE #define URLCACHEAPI_(type) EXTERN_C type STDAPICALLTYPE #endif #define BOOLAPI INTERNETAPI_(BOOL) // // internet types // typedef LPVOID HINTERNET; typedef HINTERNET * LPHINTERNET; typedef WORD INTERNET_PORT; typedef INTERNET_PORT * LPINTERNET_PORT; // // Internet APIs // // // manifests // #define INTERNET_INVALID_PORT_NUMBER 0 // use the protocol-specific default #define INTERNET_DEFAULT_FTP_PORT 21 // default for FTP servers #define INTERNET_DEFAULT_GOPHER_PORT 70 // " " gopher " #define INTERNET_DEFAULT_HTTP_PORT 80 // " " HTTP " #define INTERNET_DEFAULT_HTTPS_PORT 443 // " " HTTPS " #define INTERNET_DEFAULT_SOCKS_PORT 1080 // default for SOCKS firewall servers. // // maximum field lengths (arbitrary) // #define INTERNET_MAX_HOST_NAME_LENGTH 256 #define INTERNET_MAX_USER_NAME_LENGTH 128 #define INTERNET_MAX_PASSWORD_LENGTH 128 #define INTERNET_MAX_PORT_NUMBER_LENGTH 5 // INTERNET_PORT is unsigned short #define INTERNET_MAX_PORT_NUMBER_VALUE 65535 // maximum unsigned short value #define INTERNET_MAX_PATH_LENGTH 2048 #define INTERNET_MAX_SCHEME_LENGTH 32 // longest protocol name length #define INTERNET_MAX_URL_LENGTH (INTERNET_MAX_SCHEME_LENGTH \ + sizeof("://") \ + INTERNET_MAX_PATH_LENGTH) // // values returned by InternetQueryOption() with INTERNET_OPTION_KEEP_CONNECTION: // #define INTERNET_KEEP_ALIVE_UNKNOWN ((DWORD)-1) #define INTERNET_KEEP_ALIVE_ENABLED 1 #define INTERNET_KEEP_ALIVE_DISABLED 0 // // flags returned by InternetQueryOption() with INTERNET_OPTION_REQUEST_FLAGS // #define INTERNET_REQFLAG_FROM_CACHE 0x00000001 // response came from cache #define INTERNET_REQFLAG_ASYNC 0x00000002 // request was made asynchronously #define INTERNET_REQFLAG_VIA_PROXY 0x00000004 // request was made via a proxy #define INTERNET_REQFLAG_NO_HEADERS 0x00000008 // orginal response contained no headers #define INTERNET_REQFLAG_PASSIVE 0x00000010 // FTP: passive-mode connection #define INTERNET_REQFLAG_CACHE_WRITE_DISABLED 0x00000040 // HTTPS: this request not cacheable #define INTERNET_REQFLAG_NET_TIMEOUT 0x00000080 // w/ _FROM_CACHE: net request timed out // // flags for IDN enable/disable via INTERNET_OPTION_IDN // #define INTERNET_FLAG_IDN_DIRECT 0x00000001 // IDN enabled for direct connections #define INTERNET_FLAG_IDN_PROXY 0x00000002 // IDN enabled for proxy // // flags common to open functions (not InternetOpen()): // #define INTERNET_FLAG_RELOAD 0x80000000 // retrieve the original item // // flags for InternetOpenUrl(): // #define INTERNET_FLAG_RAW_DATA 0x40000000 // FTP/gopher find: receive the item as raw (structured) data #define INTERNET_FLAG_EXISTING_CONNECT 0x20000000 // FTP: use existing InternetConnect handle for server if possible // // flags for InternetOpen(): // #define INTERNET_FLAG_ASYNC 0x10000000 // this request is asynchronous (where supported) // // protocol-specific flags: // #define INTERNET_FLAG_PASSIVE 0x08000000 // used for FTP connections // // additional cache flags // #define INTERNET_FLAG_NO_CACHE_WRITE 0x04000000 // don't write this item to the cache #define INTERNET_FLAG_DONT_CACHE INTERNET_FLAG_NO_CACHE_WRITE #define INTERNET_FLAG_MAKE_PERSISTENT 0x02000000 // make this item persistent in cache #define INTERNET_FLAG_FROM_CACHE 0x01000000 // use offline semantics #define INTERNET_FLAG_OFFLINE INTERNET_FLAG_FROM_CACHE // // additional flags // #define INTERNET_FLAG_SECURE 0x00800000 // use PCT/SSL if applicable (HTTP) #define INTERNET_FLAG_KEEP_CONNECTION 0x00400000 // use keep-alive semantics #define INTERNET_FLAG_NO_AUTO_REDIRECT 0x00200000 // don't handle redirections automatically #define INTERNET_FLAG_READ_PREFETCH 0x00100000 // do background read prefetch #define INTERNET_FLAG_NO_COOKIES 0x00080000 // no automatic cookie handling #define INTERNET_FLAG_NO_AUTH 0x00040000 // no automatic authentication handling #define INTERNET_FLAG_RESTRICTED_ZONE 0x00020000 // apply restricted zone policies for cookies, auth #define INTERNET_FLAG_CACHE_IF_NET_FAIL 0x00010000 // return cache file if net request fails // // Security Ignore Flags, Allow HttpOpenRequest to overide // Secure Channel (SSL/PCT) failures of the following types. // #define INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP 0x00008000 // ex: https:// to http:// #define INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS 0x00004000 // ex: http:// to https:// #define INTERNET_FLAG_IGNORE_CERT_DATE_INVALID 0x00002000 // expired X509 Cert. #define INTERNET_FLAG_IGNORE_CERT_CN_INVALID 0x00001000 // bad common name in X509 Cert. // // more caching flags // #define INTERNET_FLAG_RESYNCHRONIZE 0x00000800 // asking wininet to update an item if it is newer #define INTERNET_FLAG_HYPERLINK 0x00000400 // asking wininet to do hyperlinking semantic which works right for scripts #define INTERNET_FLAG_NO_UI 0x00000200 // no cookie popup #define INTERNET_FLAG_PRAGMA_NOCACHE 0x00000100 // asking wininet to add "pragma: no-cache" #define INTERNET_FLAG_CACHE_ASYNC 0x00000080 // ok to perform lazy cache-write #define INTERNET_FLAG_FORMS_SUBMIT 0x00000040 // this is a forms submit #define INTERNET_FLAG_FWD_BACK 0x00000020 // fwd-back button op #define INTERNET_FLAG_NEED_FILE 0x00000010 // need a file for this request #define INTERNET_FLAG_MUST_CACHE_REQUEST INTERNET_FLAG_NEED_FILE // // flags for FTP // #define INTERNET_FLAG_TRANSFER_ASCII FTP_TRANSFER_TYPE_ASCII // 0x00000001 #define INTERNET_FLAG_TRANSFER_BINARY FTP_TRANSFER_TYPE_BINARY // 0x00000002 // // flags field masks // #define SECURITY_INTERNET_MASK (INTERNET_FLAG_IGNORE_CERT_CN_INVALID | \ INTERNET_FLAG_IGNORE_CERT_DATE_INVALID | \ INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS | \ INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP ) #define SECURITY_IGNORE_ERROR_MASK (INTERNET_FLAG_IGNORE_CERT_CN_INVALID | \ INTERNET_FLAG_IGNORE_CERT_DATE_INVALID | \ SECURITY_FLAG_IGNORE_UNKNOWN_CA | \ SECURITY_FLAG_IGNORE_REVOCATION ) #define INTERNET_FLAGS_MASK (INTERNET_FLAG_RELOAD \ | INTERNET_FLAG_RAW_DATA \ | INTERNET_FLAG_EXISTING_CONNECT \ | INTERNET_FLAG_ASYNC \ | INTERNET_FLAG_PASSIVE \ | INTERNET_FLAG_NO_CACHE_WRITE \ | INTERNET_FLAG_MAKE_PERSISTENT \ | INTERNET_FLAG_FROM_CACHE \ | INTERNET_FLAG_SECURE \ | INTERNET_FLAG_KEEP_CONNECTION \ | INTERNET_FLAG_NO_AUTO_REDIRECT \ | INTERNET_FLAG_READ_PREFETCH \ | INTERNET_FLAG_NO_COOKIES \ | INTERNET_FLAG_NO_AUTH \ | INTERNET_FLAG_CACHE_IF_NET_FAIL \ | SECURITY_INTERNET_MASK \ | INTERNET_FLAG_RESYNCHRONIZE \ | INTERNET_FLAG_HYPERLINK \ | INTERNET_FLAG_NO_UI \ | INTERNET_FLAG_PRAGMA_NOCACHE \ | INTERNET_FLAG_CACHE_ASYNC \ | INTERNET_FLAG_FORMS_SUBMIT \ | INTERNET_FLAG_NEED_FILE \ | INTERNET_FLAG_RESTRICTED_ZONE \ | INTERNET_FLAG_TRANSFER_BINARY \ | INTERNET_FLAG_TRANSFER_ASCII \ | INTERNET_FLAG_FWD_BACK \ | INTERNET_FLAG_BGUPDATE \ ) #define INTERNET_ERROR_MASK_INSERT_CDROM 0x1 #define INTERNET_ERROR_MASK_COMBINED_SEC_CERT 0x2 #define INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG 0X4 #define INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY 0x8 #define INTERNET_OPTIONS_MASK (~INTERNET_FLAGS_MASK) // // common per-API flags (new APIs) // #define WININET_API_FLAG_ASYNC 0x00000001 // force async operation #define WININET_API_FLAG_SYNC 0x00000004 // force sync operation #define WININET_API_FLAG_USE_CONTEXT 0x00000008 // use value supplied in dwContext (even if 0) // // INTERNET_NO_CALLBACK - if this value is presented as the dwContext parameter // then no call-backs will be made for that API // #define INTERNET_NO_CALLBACK 0 // // structures/types // // // INTERNET_SCHEME - enumerated URL scheme type // typedef enum { INTERNET_SCHEME_PARTIAL = -2, INTERNET_SCHEME_UNKNOWN = -1, INTERNET_SCHEME_DEFAULT = 0, INTERNET_SCHEME_FTP, INTERNET_SCHEME_GOPHER, INTERNET_SCHEME_HTTP, INTERNET_SCHEME_HTTPS, INTERNET_SCHEME_FILE, INTERNET_SCHEME_NEWS, INTERNET_SCHEME_MAILTO, INTERNET_SCHEME_SOCKS, INTERNET_SCHEME_JAVASCRIPT, INTERNET_SCHEME_VBSCRIPT, INTERNET_SCHEME_RES, INTERNET_SCHEME_FIRST = INTERNET_SCHEME_FTP, INTERNET_SCHEME_LAST = INTERNET_SCHEME_RES } INTERNET_SCHEME, * LPINTERNET_SCHEME; // // INTERNET_ASYNC_RESULT - this structure is returned to the application via // the callback with INTERNET_STATUS_REQUEST_COMPLETE. It is not sufficient to // just return the result of the async operation. If the API failed then the // app cannot call GetLastError() because the thread context will be incorrect. // Both the value returned by the async API and any resultant error code are // made available. The app need not check dwError if dwResult indicates that // the API succeeded (in this case dwError will be ERROR_SUCCESS) // typedef struct { // // dwResult - the HINTERNET, DWORD or BOOL return code from an async API // DWORD_PTR dwResult; // // dwError - the error code if the API failed // DWORD dwError; } INTERNET_ASYNC_RESULT, * LPINTERNET_ASYNC_RESULT; // // INTERNET_DIAGNOSTIC_SOCKET_INFO - info about the socket in use // typedef struct { DWORD_PTR Socket; DWORD SourcePort; DWORD DestPort; DWORD Flags; } INTERNET_DIAGNOSTIC_SOCKET_INFO, * LPINTERNET_DIAGNOSTIC_SOCKET_INFO; // // INTERNET_DIAGNOSTIC_SOCKET_INFO.Flags definitions // #define IDSI_FLAG_KEEP_ALIVE 0x00000001 // set if from keep-alive pool #define IDSI_FLAG_SECURE 0x00000002 // set if secure connection #define IDSI_FLAG_PROXY 0x00000004 // set if using proxy #define IDSI_FLAG_TUNNEL 0x00000008 // set if tunnelling through proxy // // INTERNET_PROXY_INFO - structure supplied with INTERNET_OPTION_PROXY to get/ // set proxy information on a InternetOpen() handle // typedef struct { // // dwAccessType - INTERNET_OPEN_TYPE_DIRECT, INTERNET_OPEN_TYPE_PROXY, or // INTERNET_OPEN_TYPE_PRECONFIG (set only) // DWORD dwAccessType; // // lpszProxy - proxy server list // LPCTSTR lpszProxy; // // lpszProxyBypass - proxy bypass list // LPCTSTR lpszProxyBypass; } INTERNET_PROXY_INFO, * LPINTERNET_PROXY_INFO; // // INTERNET_PER_CONN_OPTION_LIST - set per-connection options such as proxy // and autoconfig info // // Set and queried using Internet[Set|Query]Option with // INTERNET_OPTION_PER_CONNECTION_OPTION // typedef struct { DWORD dwOption; // option to be queried or set union { DWORD dwValue; // dword value for the option LPSTR pszValue; // pointer to string value for the option FILETIME ftValue; // file-time value for the option } Value; } INTERNET_PER_CONN_OPTIONA, * LPINTERNET_PER_CONN_OPTIONA; typedef struct { DWORD dwOption; // option to be queried or set union { DWORD dwValue; // dword value for the option LPWSTR pszValue; // pointer to string value for the option FILETIME ftValue; // file-time value for the option } Value; } INTERNET_PER_CONN_OPTIONW, * LPINTERNET_PER_CONN_OPTIONW; #ifdef UNICODE typedef INTERNET_PER_CONN_OPTIONW INTERNET_PER_CONN_OPTION; typedef LPINTERNET_PER_CONN_OPTIONW LPINTERNET_PER_CONN_OPTION; #else typedef INTERNET_PER_CONN_OPTIONA INTERNET_PER_CONN_OPTION; typedef LPINTERNET_PER_CONN_OPTIONA LPINTERNET_PER_CONN_OPTION; #endif // UNICODE typedef struct { DWORD dwSize; // size of the INTERNET_PER_CONN_OPTION_LIST struct LPSTR pszConnection; // connection name to set/query options DWORD dwOptionCount; // number of options to set/query DWORD dwOptionError; // on error, which option failed LPINTERNET_PER_CONN_OPTIONA pOptions; // array of options to set/query } INTERNET_PER_CONN_OPTION_LISTA, * LPINTERNET_PER_CONN_OPTION_LISTA; typedef struct { DWORD dwSize; // size of the INTERNET_PER_CONN_OPTION_LIST struct LPWSTR pszConnection; // connection name to set/query options DWORD dwOptionCount; // number of options to set/query DWORD dwOptionError; // on error, which option failed LPINTERNET_PER_CONN_OPTIONW pOptions; // array of options to set/query } INTERNET_PER_CONN_OPTION_LISTW, * LPINTERNET_PER_CONN_OPTION_LISTW; #ifdef UNICODE typedef INTERNET_PER_CONN_OPTION_LISTW INTERNET_PER_CONN_OPTION_LIST; typedef LPINTERNET_PER_CONN_OPTION_LISTW LPINTERNET_PER_CONN_OPTION_LIST; #else typedef INTERNET_PER_CONN_OPTION_LISTA INTERNET_PER_CONN_OPTION_LIST; typedef LPINTERNET_PER_CONN_OPTION_LISTA LPINTERNET_PER_CONN_OPTION_LIST; #endif // UNICODE // // Options used in INTERNET_PER_CONN_OPTON struct // #define INTERNET_PER_CONN_FLAGS 1 #define INTERNET_PER_CONN_PROXY_SERVER 2 #define INTERNET_PER_CONN_PROXY_BYPASS 3 #define INTERNET_PER_CONN_AUTOCONFIG_URL 4 #define INTERNET_PER_CONN_AUTODISCOVERY_FLAGS 5 #define INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL 6 #define INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS 7 #define INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME 8 #define INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL 9 #define INTERNET_PER_CONN_FLAGS_UI 10 // // PER_CONN_FLAGS // #define PROXY_TYPE_DIRECT 0x00000001 // direct to net #define PROXY_TYPE_PROXY 0x00000002 // via named proxy #define PROXY_TYPE_AUTO_PROXY_URL 0x00000004 // autoproxy URL #define PROXY_TYPE_AUTO_DETECT 0x00000008 // use autoproxy detection // // PER_CONN_AUTODISCOVERY_FLAGS // #define AUTO_PROXY_FLAG_USER_SET 0x00000001 // user changed this setting #define AUTO_PROXY_FLAG_ALWAYS_DETECT 0x00000002 // force detection even when its not needed #define AUTO_PROXY_FLAG_DETECTION_RUN 0x00000004 // detection has been run #define AUTO_PROXY_FLAG_MIGRATED 0x00000008 // migration has just been done #define AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT 0x00000010 // don't cache result of host=proxy name #define AUTO_PROXY_FLAG_CACHE_INIT_RUN 0x00000020 // don't initalize and run unless URL expired #define AUTO_PROXY_FLAG_DETECTION_SUSPECT 0x00000040 // if we're on a LAN & Modem, with only one IP, bad?!? // // INTERNET_VERSION_INFO - version information returned via // InternetQueryOption(..., INTERNET_OPTION_VERSION, ...) // typedef struct { DWORD dwMajorVersion; DWORD dwMinorVersion; } INTERNET_VERSION_INFO, * LPINTERNET_VERSION_INFO; // // HTTP_VERSION_INFO - query or set global HTTP version (1.0 or 1.1) // typedef struct { DWORD dwMajorVersion; DWORD dwMinorVersion; } HTTP_VERSION_INFO, * LPHTTP_VERSION_INFO; // // INTERNET_CONNECTED_INFO - information used to set the global connected state // typedef struct { // // dwConnectedState - new connected/disconnected state. // See INTERNET_STATE_CONNECTED, etc. // DWORD dwConnectedState; // // dwFlags - flags controlling connected->disconnected (or disconnected-> // connected) transition. See below // DWORD dwFlags; } INTERNET_CONNECTED_INFO, * LPINTERNET_CONNECTED_INFO; // // flags for INTERNET_CONNECTED_INFO dwFlags // // // ISO_FORCE_DISCONNECTED - if set when putting Wininet into disconnected mode, // all outstanding requests will be aborted with a cancelled error // #define ISO_FORCE_DISCONNECTED 0x00000001 // // URL_COMPONENTS - the constituent parts of an URL. Used in InternetCrackUrl() // and InternetCreateUrl() // // For InternetCrackUrl(), if a pointer field and its corresponding length field // are both 0 then that component is not returned. If the pointer field is NULL // but the length field is not zero, then both the pointer and length fields are // returned if both pointer and corresponding length fields are non-zero then // the pointer field points to a buffer where the component is copied. The // component may be un-escaped, depending on dwFlags // // For InternetCreateUrl(), the pointer fields should be NULL if the component // is not required. If the corresponding length field is zero then the pointer // field is the address of a zero-terminated string. If the length field is not // zero then it is the string length of the corresponding pointer field // #if _MSC_VER >= 1200 #pragma warning(push) #endif #pragma warning( disable : 4121 ) // disable alignment warning typedef struct { DWORD dwStructSize; // size of this structure. Used in version check LPSTR lpszScheme; // pointer to scheme name DWORD dwSchemeLength; // length of scheme name INTERNET_SCHEME nScheme; // enumerated scheme type (if known) LPSTR lpszHostName; // pointer to host name DWORD dwHostNameLength; // length of host name INTERNET_PORT nPort; // converted port number LPSTR lpszUserName; // pointer to user name DWORD dwUserNameLength; // length of user name LPSTR lpszPassword; // pointer to password DWORD dwPasswordLength; // length of password LPSTR lpszUrlPath; // pointer to URL-path DWORD dwUrlPathLength; // length of URL-path LPSTR lpszExtraInfo; // pointer to extra information (e.g. ?foo or #foo) DWORD dwExtraInfoLength; // length of extra information } URL_COMPONENTSA, * LPURL_COMPONENTSA; typedef struct { DWORD dwStructSize; // size of this structure. Used in version check LPWSTR lpszScheme; // pointer to scheme name DWORD dwSchemeLength; // length of scheme name INTERNET_SCHEME nScheme; // enumerated scheme type (if known) LPWSTR lpszHostName; // pointer to host name DWORD dwHostNameLength; // length of host name INTERNET_PORT nPort; // converted port number LPWSTR lpszUserName; // pointer to user name DWORD dwUserNameLength; // length of user name LPWSTR lpszPassword; // pointer to password DWORD dwPasswordLength; // length of password LPWSTR lpszUrlPath; // pointer to URL-path DWORD dwUrlPathLength; // length of URL-path LPWSTR lpszExtraInfo; // pointer to extra information (e.g. ?foo or #foo) DWORD dwExtraInfoLength; // length of extra information } URL_COMPONENTSW, * LPURL_COMPONENTSW; #ifdef UNICODE typedef URL_COMPONENTSW URL_COMPONENTS; typedef LPURL_COMPONENTSW LPURL_COMPONENTS; #else typedef URL_COMPONENTSA URL_COMPONENTS; typedef LPURL_COMPONENTSA LPURL_COMPONENTS; #endif // UNICODE #if _MSC_VER >= 1200 #pragma warning(pop) #else #pragma warning( default : 4121 ) // restore alignment warning #endif // // INTERNET_CERTIFICATE_INFO lpBuffer - contains the certificate returned from // the server // typedef struct { // // ftExpiry - date the certificate expires. // FILETIME ftExpiry; // // ftStart - date the certificate becomes valid. // FILETIME ftStart; // // lpszSubjectInfo - the name of organization, site, and server // the cert. was issued for. // LPTSTR lpszSubjectInfo; // // lpszIssuerInfo - the name of orgainzation, site, and server // the cert was issues by. // LPTSTR lpszIssuerInfo; // // lpszProtocolName - the name of the protocol used to provide the secure // connection. // LPTSTR lpszProtocolName; // // lpszSignatureAlgName - the name of the algorithm used for signing // the certificate. // LPTSTR lpszSignatureAlgName; // // lpszEncryptionAlgName - the name of the algorithm used for // doing encryption over the secure channel (SSL/PCT) connection. // LPTSTR lpszEncryptionAlgName; // // dwKeySize - size of the key. // DWORD dwKeySize; } INTERNET_CERTIFICATE_INFO, * LPINTERNET_CERTIFICATE_INFO; // // INTERNET_BUFFERS - combines headers and data. May be chained for e.g. file // upload or scatter/gather operations. For chunked read/write, lpcszHeader // contains the chunked-ext // typedef struct _INTERNET_BUFFERSA { DWORD dwStructSize; // used for API versioning. Set to sizeof(INTERNET_BUFFERS) struct _INTERNET_BUFFERSA * Next; // chain of buffers LPCSTR lpcszHeader; // pointer to headers (may be NULL) DWORD dwHeadersLength; // length of headers if not NULL DWORD dwHeadersTotal; // size of headers if not enough buffer LPVOID lpvBuffer; // pointer to data buffer (may be NULL) DWORD dwBufferLength; // length of data buffer if not NULL DWORD dwBufferTotal; // total size of chunk, or content-length if not chunked DWORD dwOffsetLow; // used for read-ranges (only used in HttpSendRequest2) DWORD dwOffsetHigh; } INTERNET_BUFFERSA, * LPINTERNET_BUFFERSA; typedef struct _INTERNET_BUFFERSW { DWORD dwStructSize; // used for API versioning. Set to sizeof(INTERNET_BUFFERS) struct _INTERNET_BUFFERSW * Next; // chain of buffers LPCWSTR lpcszHeader; // pointer to headers (may be NULL) DWORD dwHeadersLength; // length of headers if not NULL DWORD dwHeadersTotal; // size of headers if not enough buffer LPVOID lpvBuffer; // pointer to data buffer (may be NULL) DWORD dwBufferLength; // length of data buffer if not NULL DWORD dwBufferTotal; // total size of chunk, or content-length if not chunked DWORD dwOffsetLow; // used for read-ranges (only used in HttpSendRequest2) DWORD dwOffsetHigh; } INTERNET_BUFFERSW, * LPINTERNET_BUFFERSW; #ifdef UNICODE typedef INTERNET_BUFFERSW INTERNET_BUFFERS; typedef LPINTERNET_BUFFERSW LPINTERNET_BUFFERS; #else typedef INTERNET_BUFFERSA INTERNET_BUFFERS; typedef LPINTERNET_BUFFERSA LPINTERNET_BUFFERS; #endif // UNICODE // // prototypes // BOOLAPI InternetTimeFromSystemTimeA( __in CONST SYSTEMTIME *pst, // input GMT time __in DWORD dwRFC, // RFC format __out_bcount(cbTime) LPSTR lpszTime, // output string buffer __in DWORD cbTime // output buffer size ); BOOLAPI InternetTimeFromSystemTimeW( __in CONST SYSTEMTIME *pst, // input GMT time __in DWORD dwRFC, // RFC format __out_bcount(cbTime) LPWSTR lpszTime, // output string buffer __in DWORD cbTime // output buffer size ); #ifdef UNICODE #define InternetTimeFromSystemTime InternetTimeFromSystemTimeW #else #ifdef _WINX32_ #define InternetTimeFromSystemTime InternetTimeFromSystemTimeA #else BOOLAPI InternetTimeFromSystemTime( __in CONST SYSTEMTIME *pst, // input GMT time __in DWORD dwRFC, // RFC format __out_bcount(cbTime) LPSTR lpszTime, // output string buffer __in DWORD cbTime // output buffer size ); #endif // _WINX32_ #endif // !UNICODE // // constants for InternetTimeFromSystemTime // #define INTERNET_RFC1123_FORMAT 0 #define INTERNET_RFC1123_BUFSIZE 30 BOOLAPI InternetTimeToSystemTimeA( __in LPCSTR lpszTime, // NULL terminated string __out SYSTEMTIME *pst, // output in GMT time __reserved DWORD dwReserved ); BOOLAPI InternetTimeToSystemTimeW( __in LPCWSTR lpszTime, // NULL terminated string __out SYSTEMTIME *pst, // output in GMT time __reserved DWORD dwReserved ); #ifdef UNICODE #define InternetTimeToSystemTime InternetTimeToSystemTimeW #else #ifdef _WINX32_ #define InternetTimeToSystemTime InternetTimeToSystemTimeA #else BOOLAPI InternetTimeToSystemTime( __in LPCSTR lpszTime, // NULL terminated string __out SYSTEMTIME *pst, // output in GMT time __reserved DWORD dwReserved ); #endif // _WINX32_ #endif // !UNICODE BOOLAPI InternetCrackUrlA( __in_ecount(dwUrlLength) LPCSTR lpszUrl, __in DWORD dwUrlLength, __in DWORD dwFlags, __inout LPURL_COMPONENTSA lpUrlComponents ); BOOLAPI InternetCrackUrlW( __in_ecount(dwUrlLength) LPCWSTR lpszUrl, __in DWORD dwUrlLength, __in DWORD dwFlags, __inout LPURL_COMPONENTSW lpUrlComponents ); #ifdef UNICODE #define InternetCrackUrl InternetCrackUrlW #else #define InternetCrackUrl InternetCrackUrlA #endif // !UNICODE BOOLAPI InternetCreateUrlA( __in LPURL_COMPONENTSA lpUrlComponents, __in DWORD dwFlags, __out_ecount_opt(*lpdwUrlLength) LPSTR lpszUrl, __inout LPDWORD lpdwUrlLength ); BOOLAPI InternetCreateUrlW( __in LPURL_COMPONENTSW lpUrlComponents, __in DWORD dwFlags, __out_ecount_opt(*lpdwUrlLength) LPWSTR lpszUrl, __inout LPDWORD lpdwUrlLength ); #ifdef UNICODE #define InternetCreateUrl InternetCreateUrlW #else #define InternetCreateUrl InternetCreateUrlA #endif // !UNICODE BOOLAPI InternetCanonicalizeUrlA( __in LPCSTR lpszUrl, __out_ecount(*lpdwBufferLength) LPSTR lpszBuffer, __inout LPDWORD lpdwBufferLength, __in DWORD dwFlags ); BOOLAPI InternetCanonicalizeUrlW( __in LPCWSTR lpszUrl, __out_ecount(*lpdwBufferLength) LPWSTR lpszBuffer, __inout LPDWORD lpdwBufferLength, __in DWORD dwFlags ); #ifdef UNICODE #define InternetCanonicalizeUrl InternetCanonicalizeUrlW #else #define InternetCanonicalizeUrl InternetCanonicalizeUrlA #endif // !UNICODE BOOLAPI InternetCombineUrlA( __in LPCSTR lpszBaseUrl, __in LPCSTR lpszRelativeUrl, __out_ecount(*lpdwBufferLength) LPSTR lpszBuffer, __inout LPDWORD lpdwBufferLength, __in DWORD dwFlags ); BOOLAPI InternetCombineUrlW( __in LPCWSTR lpszBaseUrl, __in LPCWSTR lpszRelativeUrl, __out_ecount(*lpdwBufferLength) LPWSTR lpszBuffer, __inout LPDWORD lpdwBufferLength, __in DWORD dwFlags ); #ifdef UNICODE #define InternetCombineUrl InternetCombineUrlW #else #define InternetCombineUrl InternetCombineUrlA #endif // !UNICODE // // flags for InternetCrackUrl() and InternetCreateUrl() // #define ICU_ESCAPE 0x80000000 // (un)escape URL characters #define ICU_USERNAME 0x40000000 // use internal username & password // // flags for InternetCanonicalizeUrl() and InternetCombineUrl() // #define ICU_NO_ENCODE 0x20000000 // Don't convert unsafe characters to escape sequence #define ICU_DECODE 0x10000000 // Convert %XX escape sequences to characters #define ICU_NO_META 0x08000000 // Don't convert .. etc. meta path sequences #define ICU_ENCODE_SPACES_ONLY 0x04000000 // Encode spaces only #define ICU_BROWSER_MODE 0x02000000 // Special encode/decode rules for browser #define ICU_ENCODE_PERCENT 0x00001000 // Encode any percent (ASCII25) // signs encountered, default is to not encode percent. INTERNETAPI_(HINTERNET) InternetOpenA( __in_opt LPCSTR lpszAgent, __in DWORD dwAccessType, __in_opt LPCSTR lpszProxy, __in_opt LPCSTR lpszProxyBypass, __in DWORD dwFlags ); INTERNETAPI_(HINTERNET) InternetOpenW( __in_opt LPCWSTR lpszAgent, __in DWORD dwAccessType, __in_opt LPCWSTR lpszProxy, __in_opt LPCWSTR lpszProxyBypass, __in DWORD dwFlags ); #ifdef UNICODE #define InternetOpen InternetOpenW #else #define InternetOpen InternetOpenA #endif // !UNICODE // // access types for InternetOpen() // #define INTERNET_OPEN_TYPE_PRECONFIG 0 // use registry configuration #define INTERNET_OPEN_TYPE_DIRECT 1 // direct to net #define INTERNET_OPEN_TYPE_PROXY 3 // via named proxy #define INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY 4 // prevent using java/script/INS // // old names for access types // #define PRE_CONFIG_INTERNET_ACCESS INTERNET_OPEN_TYPE_PRECONFIG #define LOCAL_INTERNET_ACCESS INTERNET_OPEN_TYPE_DIRECT #define CERN_PROXY_INTERNET_ACCESS INTERNET_OPEN_TYPE_PROXY BOOLAPI InternetCloseHandle( __in HINTERNET hInternet ); INTERNETAPI_(HINTERNET) InternetConnectA( __in HINTERNET hInternet, __in LPCSTR lpszServerName, __in INTERNET_PORT nServerPort, __in_opt LPCSTR lpszUserName, __in_opt LPCSTR lpszPassword, __in DWORD dwService, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(HINTERNET) InternetConnectW( __in HINTERNET hInternet, __in LPCWSTR lpszServerName, __in INTERNET_PORT nServerPort, __in_opt LPCWSTR lpszUserName, __in_opt LPCWSTR lpszPassword, __in DWORD dwService, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define InternetConnect InternetConnectW #else #define InternetConnect InternetConnectA #endif // !UNICODE // // service types for InternetConnect() // #define INTERNET_SERVICE_FTP 1 #define INTERNET_SERVICE_GOPHER 2 #define INTERNET_SERVICE_HTTP 3 INTERNETAPI_(HINTERNET) InternetOpenUrlA( __in HINTERNET hInternet, __in LPCSTR lpszUrl, __in_ecount_opt(dwHeadersLength) LPCSTR lpszHeaders, __in DWORD dwHeadersLength, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(HINTERNET) InternetOpenUrlW( __in HINTERNET hInternet, __in LPCWSTR lpszUrl, __in_ecount_opt(dwHeadersLength) LPCWSTR lpszHeaders, __in DWORD dwHeadersLength, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define InternetOpenUrl InternetOpenUrlW #else #define InternetOpenUrl InternetOpenUrlA #endif // !UNICODE BOOLAPI InternetReadFile( __in HINTERNET hFile, __out_bcount(dwNumberOfBytesToRead) __out_data_source(NETWORK) LPVOID lpBuffer, __in DWORD dwNumberOfBytesToRead, __out LPDWORD lpdwNumberOfBytesRead ); INTERNETAPI_(BOOL) InternetReadFileExA( __in HINTERNET hFile, __out __out_data_source(NETWORK) LPINTERNET_BUFFERSA lpBuffersOut, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(BOOL) InternetReadFileExW( __in HINTERNET hFile, __out __out_data_source(NETWORK) LPINTERNET_BUFFERSW lpBuffersOut, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define InternetReadFileEx InternetReadFileExW #else #define InternetReadFileEx InternetReadFileExA #endif // !UNICODE // // flags for InternetReadFileEx() // #define IRF_ASYNC WININET_API_FLAG_ASYNC #define IRF_SYNC WININET_API_FLAG_SYNC #define IRF_USE_CONTEXT WININET_API_FLAG_USE_CONTEXT #define IRF_NO_WAIT 0x00000008 INTERNETAPI_(DWORD) InternetSetFilePointer( __in HINTERNET hFile, __in LONG lDistanceToMove, __inout_opt PLONG lpDistanceToMoveHigh, __in DWORD dwMoveMethod, __reserved DWORD_PTR dwContext ); BOOLAPI InternetWriteFile( __in HINTERNET hFile, __in_bcount(dwNumberOfBytesToWrite) LPCVOID lpBuffer, __in DWORD dwNumberOfBytesToWrite, __out LPDWORD lpdwNumberOfBytesWritten ); BOOLAPI InternetQueryDataAvailable( __in HINTERNET hFile, __out_opt LPDWORD __out_data_source(NETWORK) lpdwNumberOfBytesAvailable, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); BOOLAPI InternetFindNextFileA( __in HINTERNET hFind, __out LPVOID lpvFindData ); BOOLAPI InternetFindNextFileW( __in HINTERNET hFind, __out LPVOID lpvFindData ); #ifdef UNICODE #define InternetFindNextFile InternetFindNextFileW #else #define InternetFindNextFile InternetFindNextFileA #endif // !UNICODE BOOLAPI InternetQueryOptionA( __in_opt HINTERNET hInternet, __in DWORD dwOption, __out_bcount_opt(*lpdwBufferLength) __out_data_source(NETWORK) LPVOID lpBuffer, __inout LPDWORD lpdwBufferLength ); BOOLAPI InternetQueryOptionW( __in_opt HINTERNET hInternet, __in DWORD dwOption, __out_bcount_opt(*lpdwBufferLength) __out_data_source(NETWORK) LPVOID lpBuffer, __inout LPDWORD lpdwBufferLength ); #ifdef UNICODE #define InternetQueryOption InternetQueryOptionW #else #define InternetQueryOption InternetQueryOptionA #endif // !UNICODE BOOLAPI InternetSetOptionA( __in_opt HINTERNET hInternet, __in DWORD dwOption, __in_opt LPVOID lpBuffer, __in DWORD dwBufferLength ); BOOLAPI InternetSetOptionW( __in_opt HINTERNET hInternet, __in DWORD dwOption, __in_opt LPVOID lpBuffer, __in DWORD dwBufferLength ); #ifdef UNICODE #define InternetSetOption InternetSetOptionW #else #define InternetSetOption InternetSetOptionA #endif // !UNICODE BOOLAPI InternetSetOptionExA( __in_opt HINTERNET hInternet, __in DWORD dwOption, __in_opt LPVOID lpBuffer, __in DWORD dwBufferLength, __in DWORD dwFlags ); BOOLAPI InternetSetOptionExW( __in_opt HINTERNET hInternet, __in DWORD dwOption, __in_opt LPVOID lpBuffer, __in DWORD dwBufferLength, __in DWORD dwFlags ); #ifdef UNICODE #define InternetSetOptionEx InternetSetOptionExW #else #define InternetSetOptionEx InternetSetOptionExA #endif // !UNICODE BOOLAPI InternetLockRequestFile( __in HINTERNET hInternet, __out HANDLE * lphLockRequestInfo ); BOOLAPI InternetUnlockRequestFile( __inout HANDLE hLockRequestInfo ); // // flags for InternetSetOptionEx() // #define ISO_GLOBAL 0x00000001 // modify option globally #define ISO_REGISTRY 0x00000002 // write option to registry (where applicable) #define ISO_VALID_FLAGS (ISO_GLOBAL | ISO_REGISTRY) // // options manifests for Internet{Query|Set}Option // #define INTERNET_OPTION_CALLBACK 1 #define INTERNET_OPTION_CONNECT_TIMEOUT 2 #define INTERNET_OPTION_CONNECT_RETRIES 3 #define INTERNET_OPTION_CONNECT_BACKOFF 4 #define INTERNET_OPTION_SEND_TIMEOUT 5 #define INTERNET_OPTION_CONTROL_SEND_TIMEOUT INTERNET_OPTION_SEND_TIMEOUT #define INTERNET_OPTION_RECEIVE_TIMEOUT 6 #define INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT INTERNET_OPTION_RECEIVE_TIMEOUT #define INTERNET_OPTION_DATA_SEND_TIMEOUT 7 #define INTERNET_OPTION_DATA_RECEIVE_TIMEOUT 8 #define INTERNET_OPTION_HANDLE_TYPE 9 #define INTERNET_OPTION_LISTEN_TIMEOUT 11 #define INTERNET_OPTION_READ_BUFFER_SIZE 12 #define INTERNET_OPTION_WRITE_BUFFER_SIZE 13 #define INTERNET_OPTION_ASYNC_ID 15 #define INTERNET_OPTION_ASYNC_PRIORITY 16 #define INTERNET_OPTION_PARENT_HANDLE 21 #define INTERNET_OPTION_KEEP_CONNECTION 22 #define INTERNET_OPTION_REQUEST_FLAGS 23 #define INTERNET_OPTION_EXTENDED_ERROR 24 #define INTERNET_OPTION_OFFLINE_MODE 26 #define INTERNET_OPTION_CACHE_STREAM_HANDLE 27 #define INTERNET_OPTION_USERNAME 28 #define INTERNET_OPTION_PASSWORD 29 #define INTERNET_OPTION_ASYNC 30 #define INTERNET_OPTION_SECURITY_FLAGS 31 #define INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT 32 #define INTERNET_OPTION_DATAFILE_NAME 33 #define INTERNET_OPTION_URL 34 #define INTERNET_OPTION_SECURITY_CERTIFICATE 35 #define INTERNET_OPTION_SECURITY_KEY_BITNESS 36 #define INTERNET_OPTION_REFRESH 37 #define INTERNET_OPTION_PROXY 38 #define INTERNET_OPTION_SETTINGS_CHANGED 39 #define INTERNET_OPTION_VERSION 40 #define INTERNET_OPTION_USER_AGENT 41 #define INTERNET_OPTION_END_BROWSER_SESSION 42 #define INTERNET_OPTION_PROXY_USERNAME 43 #define INTERNET_OPTION_PROXY_PASSWORD 44 #define INTERNET_OPTION_CONTEXT_VALUE 45 #define INTERNET_OPTION_CONNECT_LIMIT 46 #define INTERNET_OPTION_SECURITY_SELECT_CLIENT_CERT 47 #define INTERNET_OPTION_POLICY 48 #define INTERNET_OPTION_DISCONNECTED_TIMEOUT 49 #define INTERNET_OPTION_CONNECTED_STATE 50 #define INTERNET_OPTION_IDLE_STATE 51 #define INTERNET_OPTION_OFFLINE_SEMANTICS 52 #define INTERNET_OPTION_SECONDARY_CACHE_KEY 53 #define INTERNET_OPTION_CALLBACK_FILTER 54 #define INTERNET_OPTION_CONNECT_TIME 55 #define INTERNET_OPTION_SEND_THROUGHPUT 56 #define INTERNET_OPTION_RECEIVE_THROUGHPUT 57 #define INTERNET_OPTION_REQUEST_PRIORITY 58 #define INTERNET_OPTION_HTTP_VERSION 59 #define INTERNET_OPTION_RESET_URLCACHE_SESSION 60 #define INTERNET_OPTION_ERROR_MASK 62 #define INTERNET_OPTION_FROM_CACHE_TIMEOUT 63 #define INTERNET_OPTION_BYPASS_EDITED_ENTRY 64 #define INTERNET_OPTION_HTTP_DECODING 65 #define INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO 67 #define INTERNET_OPTION_CODEPAGE 68 #define INTERNET_OPTION_CACHE_TIMESTAMPS 69 #define INTERNET_OPTION_DISABLE_AUTODIAL 70 #define INTERNET_OPTION_MAX_CONNS_PER_SERVER 73 #define INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER 74 #define INTERNET_OPTION_PER_CONNECTION_OPTION 75 #define INTERNET_OPTION_DIGEST_AUTH_UNLOAD 76 #define INTERNET_OPTION_IGNORE_OFFLINE 77 #define INTERNET_OPTION_IDENTITY 78 #define INTERNET_OPTION_REMOVE_IDENTITY 79 #define INTERNET_OPTION_ALTER_IDENTITY 80 #define INTERNET_OPTION_SUPPRESS_BEHAVIOR 81 #define INTERNET_OPTION_AUTODIAL_MODE 82 #define INTERNET_OPTION_AUTODIAL_CONNECTION 83 #define INTERNET_OPTION_CLIENT_CERT_CONTEXT 84 #define INTERNET_OPTION_AUTH_FLAGS 85 #define INTERNET_OPTION_COOKIES_3RD_PARTY 86 #define INTERNET_OPTION_DISABLE_PASSPORT_AUTH 87 #define INTERNET_OPTION_SEND_UTF8_SERVERNAME_TO_PROXY 88 #define INTERNET_OPTION_EXEMPT_CONNECTION_LIMIT 89 #define INTERNET_OPTION_ENABLE_PASSPORT_AUTH 90 #define INTERNET_OPTION_HIBERNATE_INACTIVE_WORKER_THREADS 91 #define INTERNET_OPTION_ACTIVATE_WORKER_THREADS 92 #define INTERNET_OPTION_RESTORE_WORKER_THREAD_DEFAULTS 93 #define INTERNET_OPTION_SOCKET_SEND_BUFFER_LENGTH 94 #define INTERNET_OPTION_PROXY_SETTINGS_CHANGED 95 #define INTERNET_OPTION_DATAFILE_EXT 96 #define INTERNET_OPTION_CODEPAGE_PATH 100 #define INTERNET_OPTION_CODEPAGE_EXTRA 101 #define INTERNET_OPTION_IDN 102 #define INTERNET_OPTION_MAX_CONNS_PER_PROXY 103 #define INTERNET_OPTION_SUPPRESS_SERVER_AUTH 104 #define INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT 105 #define INTERNET_FIRST_OPTION INTERNET_OPTION_CALLBACK #define INTERNET_LAST_OPTION INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT // // values for INTERNET_OPTION_PRIORITY // #define INTERNET_PRIORITY_FOREGROUND 1000 // // handle types // #define INTERNET_HANDLE_TYPE_INTERNET 1 #define INTERNET_HANDLE_TYPE_CONNECT_FTP 2 #define INTERNET_HANDLE_TYPE_CONNECT_GOPHER 3 #define INTERNET_HANDLE_TYPE_CONNECT_HTTP 4 #define INTERNET_HANDLE_TYPE_FTP_FIND 5 #define INTERNET_HANDLE_TYPE_FTP_FIND_HTML 6 #define INTERNET_HANDLE_TYPE_FTP_FILE 7 #define INTERNET_HANDLE_TYPE_FTP_FILE_HTML 8 #define INTERNET_HANDLE_TYPE_GOPHER_FIND 9 #define INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML 10 #define INTERNET_HANDLE_TYPE_GOPHER_FILE 11 #define INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML 12 #define INTERNET_HANDLE_TYPE_HTTP_REQUEST 13 #define INTERNET_HANDLE_TYPE_FILE_REQUEST 14 // // values for INTERNET_OPTION_AUTH_FLAGS // #define AUTH_FLAG_DISABLE_NEGOTIATE 0x00000001 #define AUTH_FLAG_ENABLE_NEGOTIATE 0x00000002 #define AUTH_FLAG_DISABLE_BASIC_CLEARCHANNEL 0x00000004 // // values for INTERNET_OPTION_SECURITY_FLAGS // // query only #define SECURITY_FLAG_SECURE 0x00000001 // can query only #define SECURITY_FLAG_STRENGTH_WEAK 0x10000000 #define SECURITY_FLAG_STRENGTH_MEDIUM 0x40000000 #define SECURITY_FLAG_STRENGTH_STRONG 0x20000000 #define SECURITY_FLAG_UNKNOWNBIT 0x80000000 #define SECURITY_FLAG_FORTEZZA 0x08000000 #define SECURITY_FLAG_NORMALBITNESS SECURITY_FLAG_STRENGTH_WEAK // The following are unused #define SECURITY_FLAG_SSL 0x00000002 #define SECURITY_FLAG_SSL3 0x00000004 #define SECURITY_FLAG_PCT 0x00000008 #define SECURITY_FLAG_PCT4 0x00000010 #define SECURITY_FLAG_IETFSSL4 0x00000020 // The following are for backwards compatability only. #define SECURITY_FLAG_40BIT SECURITY_FLAG_STRENGTH_WEAK #define SECURITY_FLAG_128BIT SECURITY_FLAG_STRENGTH_STRONG #define SECURITY_FLAG_56BIT SECURITY_FLAG_STRENGTH_MEDIUM // setable flags #define SECURITY_FLAG_IGNORE_REVOCATION 0x00000080 #define SECURITY_FLAG_IGNORE_UNKNOWN_CA 0x00000100 #define SECURITY_FLAG_IGNORE_WRONG_USAGE 0x00000200 #define SECURITY_FLAG_IGNORE_CERT_CN_INVALID INTERNET_FLAG_IGNORE_CERT_CN_INVALID #define SECURITY_FLAG_IGNORE_CERT_DATE_INVALID INTERNET_FLAG_IGNORE_CERT_DATE_INVALID #define SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS #define SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP #define SECURITY_SET_MASK (SECURITY_FLAG_IGNORE_REVOCATION |\ SECURITY_FLAG_IGNORE_UNKNOWN_CA |\ SECURITY_FLAG_IGNORE_CERT_CN_INVALID |\ SECURITY_FLAG_IGNORE_CERT_DATE_INVALID |\ SECURITY_FLAG_IGNORE_WRONG_USAGE) // valid autodial modes #define AUTODIAL_MODE_NEVER 1 #define AUTODIAL_MODE_ALWAYS 2 #define AUTODIAL_MODE_NO_NETWORK_PRESENT 4 BOOLAPI InternetGetLastResponseInfoA( __out LPDWORD lpdwError, __out_ecount_opt(*lpdwBufferLength) LPSTR lpszBuffer, __inout LPDWORD lpdwBufferLength ); BOOLAPI InternetGetLastResponseInfoW( __out LPDWORD lpdwError, __out_ecount_opt(*lpdwBufferLength) LPWSTR lpszBuffer, __inout LPDWORD lpdwBufferLength ); #ifdef UNICODE #define InternetGetLastResponseInfo InternetGetLastResponseInfoW #else #define InternetGetLastResponseInfo InternetGetLastResponseInfoA #endif // !UNICODE // // callback function for InternetSetStatusCallback // typedef VOID (CALLBACK * INTERNET_STATUS_CALLBACK)( __in HINTERNET hInternet, __in_opt DWORD_PTR dwContext, __in DWORD dwInternetStatus, __in_opt LPVOID lpvStatusInformation, __in DWORD dwStatusInformationLength ); typedef INTERNET_STATUS_CALLBACK * LPINTERNET_STATUS_CALLBACK; INTERNETAPI_(INTERNET_STATUS_CALLBACK) InternetSetStatusCallbackA( __in HINTERNET hInternet, __in_opt INTERNET_STATUS_CALLBACK lpfnInternetCallback ); INTERNETAPI_(INTERNET_STATUS_CALLBACK) InternetSetStatusCallbackW( __in HINTERNET hInternet, __in_opt INTERNET_STATUS_CALLBACK lpfnInternetCallback ); #ifdef UNICODE #define InternetSetStatusCallback InternetSetStatusCallbackW #else #ifdef _WINX32_ #define InternetSetStatusCallback InternetSetStatusCallbackA #else INTERNETAPI_(INTERNET_STATUS_CALLBACK) InternetSetStatusCallback( __in HINTERNET hInternet, __in_opt INTERNET_STATUS_CALLBACK lpfnInternetCallback ); #endif // _WINX32_ #endif // !UNICODE // // status manifests for Internet status callback // #define INTERNET_STATUS_RESOLVING_NAME 10 #define INTERNET_STATUS_NAME_RESOLVED 11 #define INTERNET_STATUS_CONNECTING_TO_SERVER 20 #define INTERNET_STATUS_CONNECTED_TO_SERVER 21 #define INTERNET_STATUS_SENDING_REQUEST 30 #define INTERNET_STATUS_REQUEST_SENT 31 #define INTERNET_STATUS_RECEIVING_RESPONSE 40 #define INTERNET_STATUS_RESPONSE_RECEIVED 41 #define INTERNET_STATUS_CTL_RESPONSE_RECEIVED 42 #define INTERNET_STATUS_PREFETCH 43 #define INTERNET_STATUS_CLOSING_CONNECTION 50 #define INTERNET_STATUS_CONNECTION_CLOSED 51 #define INTERNET_STATUS_HANDLE_CREATED 60 #define INTERNET_STATUS_HANDLE_CLOSING 70 #define INTERNET_STATUS_DETECTING_PROXY 80 #define INTERNET_STATUS_REQUEST_COMPLETE 100 #define INTERNET_STATUS_REDIRECT 110 #define INTERNET_STATUS_INTERMEDIATE_RESPONSE 120 #define INTERNET_STATUS_USER_INPUT_REQUIRED 140 #define INTERNET_STATUS_STATE_CHANGE 200 #define INTERNET_STATUS_COOKIE_SENT 320 #define INTERNET_STATUS_COOKIE_RECEIVED 321 #define INTERNET_STATUS_PRIVACY_IMPACTED 324 #define INTERNET_STATUS_P3P_HEADER 325 #define INTERNET_STATUS_P3P_POLICYREF 326 #define INTERNET_STATUS_COOKIE_HISTORY 327 // // the following can be indicated in a state change notification: // #define INTERNET_STATE_CONNECTED 0x00000001 // connected state (mutually exclusive with disconnected) #define INTERNET_STATE_DISCONNECTED 0x00000002 // disconnected from network #define INTERNET_STATE_DISCONNECTED_BY_USER 0x00000010 // disconnected by user request #define INTERNET_STATE_IDLE 0x00000100 // no network requests being made (by Wininet) #define INTERNET_STATE_BUSY 0x00000200 // network requests being made (by Wininet) // // the following values are used for cookie state: // typedef enum { COOKIE_STATE_UNKNOWN = 0x0, COOKIE_STATE_ACCEPT = 0x1, COOKIE_STATE_PROMPT = 0x2, COOKIE_STATE_LEASH = 0x3, COOKIE_STATE_DOWNGRADE = 0x4, COOKIE_STATE_REJECT = 0x5, COOKIE_STATE_MAX = COOKIE_STATE_REJECT, } InternetCookieState; typedef struct { int cSession; // Session cookies received int cPersistent; // Persistent cookies received int cAccepted; // Number of cookies accepted int cLeashed; // ... leashed int cDowngraded; // ... converted to session-cookies int cBlocked; // ... rejected const char *pszLocation; // Optional: URL associated with reported cookie events // This can be used to override request URL } IncomingCookieState; typedef struct { int cSent; int cSuppressed; const char *pszLocation; // Optional: URL associated with reported cookie events // This can be used to override request URL } OutgoingCookieState; typedef struct { BOOL fAccepted; BOOL fLeashed; BOOL fDowngraded; BOOL fRejected; } InternetCookieHistory; typedef struct { DWORD dwCookieState; BOOL fAllowSession; } CookieDecision; // // if the following value is returned by InternetSetStatusCallback, then // probably an invalid (non-code) address was supplied for the callback // #define INTERNET_INVALID_STATUS_CALLBACK ((INTERNET_STATUS_CALLBACK)(-1L)) // // FTP // // // manifests // #define FTP_TRANSFER_TYPE_UNKNOWN 0x00000000 #define FTP_TRANSFER_TYPE_ASCII 0x00000001 #define FTP_TRANSFER_TYPE_BINARY 0x00000002 #define FTP_TRANSFER_TYPE_MASK (FTP_TRANSFER_TYPE_ASCII | FTP_TRANSFER_TYPE_BINARY) // // prototypes // INTERNETAPI_(HINTERNET) FtpFindFirstFileA( __in HINTERNET hConnect, __in_opt LPCSTR lpszSearchFile, __out_opt LPWIN32_FIND_DATAA lpFindFileData, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(HINTERNET) FtpFindFirstFileW( __in HINTERNET hConnect, __in_opt LPCWSTR lpszSearchFile, __out_opt LPWIN32_FIND_DATAW lpFindFileData, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define FtpFindFirstFile FtpFindFirstFileW #else #define FtpFindFirstFile FtpFindFirstFileA #endif // !UNICODE BOOLAPI FtpGetFileA( __in HINTERNET hConnect, __in LPCSTR lpszRemoteFile, __in LPCSTR lpszNewFile, __in BOOL fFailIfExists, __in DWORD dwFlagsAndAttributes, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); BOOLAPI FtpGetFileW( __in HINTERNET hConnect, __in LPCWSTR lpszRemoteFile, __in LPCWSTR lpszNewFile, __in BOOL fFailIfExists, __in DWORD dwFlagsAndAttributes, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define FtpGetFile FtpGetFileW #else #define FtpGetFile FtpGetFileA #endif // !UNICODE BOOLAPI FtpPutFileA( __in HINTERNET hConnect, __in LPCSTR lpszLocalFile, __in LPCSTR lpszNewRemoteFile, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); BOOLAPI FtpPutFileW( __in HINTERNET hConnect, __in LPCWSTR lpszLocalFile, __in LPCWSTR lpszNewRemoteFile, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define FtpPutFile FtpPutFileW #else #define FtpPutFile FtpPutFileA #endif // !UNICODE BOOLAPI FtpGetFileEx( __in HINTERNET hFtpSession, __in LPCSTR lpszRemoteFile, __in LPCWSTR lpszNewFile, __in BOOL fFailIfExists, __in DWORD dwFlagsAndAttributes, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); BOOLAPI FtpPutFileEx( __in HINTERNET hFtpSession, __in LPCWSTR lpszLocalFile, __in LPCSTR lpszNewRemoteFile, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); BOOLAPI FtpDeleteFileA( __in HINTERNET hConnect, __in LPCSTR lpszFileName ); BOOLAPI FtpDeleteFileW( __in HINTERNET hConnect, __in LPCWSTR lpszFileName ); #ifdef UNICODE #define FtpDeleteFile FtpDeleteFileW #else #define FtpDeleteFile FtpDeleteFileA #endif // !UNICODE BOOLAPI FtpRenameFileA( __in HINTERNET hConnect, __in LPCSTR lpszExisting, __in LPCSTR lpszNew ); BOOLAPI FtpRenameFileW( __in HINTERNET hConnect, __in LPCWSTR lpszExisting, __in LPCWSTR lpszNew ); #ifdef UNICODE #define FtpRenameFile FtpRenameFileW #else #define FtpRenameFile FtpRenameFileA #endif // !UNICODE INTERNETAPI_(HINTERNET) FtpOpenFileA( __in HINTERNET hConnect, __in LPCSTR lpszFileName, __in DWORD dwAccess, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(HINTERNET) FtpOpenFileW( __in HINTERNET hConnect, __in LPCWSTR lpszFileName, __in DWORD dwAccess, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define FtpOpenFile FtpOpenFileW #else #define FtpOpenFile FtpOpenFileA #endif // !UNICODE BOOLAPI FtpCreateDirectoryA( __in HINTERNET hConnect, __in LPCSTR lpszDirectory ); BOOLAPI FtpCreateDirectoryW( __in HINTERNET hConnect, __in LPCWSTR lpszDirectory ); #ifdef UNICODE #define FtpCreateDirectory FtpCreateDirectoryW #else #define FtpCreateDirectory FtpCreateDirectoryA #endif // !UNICODE BOOLAPI FtpRemoveDirectoryA( __in HINTERNET hConnect, __in LPCSTR lpszDirectory ); BOOLAPI FtpRemoveDirectoryW( __in HINTERNET hConnect, __in LPCWSTR lpszDirectory ); #ifdef UNICODE #define FtpRemoveDirectory FtpRemoveDirectoryW #else #define FtpRemoveDirectory FtpRemoveDirectoryA #endif // !UNICODE BOOLAPI FtpSetCurrentDirectoryA( __in HINTERNET hConnect, __in LPCSTR lpszDirectory ); BOOLAPI FtpSetCurrentDirectoryW( __in HINTERNET hConnect, __in LPCWSTR lpszDirectory ); #ifdef UNICODE #define FtpSetCurrentDirectory FtpSetCurrentDirectoryW #else #define FtpSetCurrentDirectory FtpSetCurrentDirectoryA #endif // !UNICODE BOOLAPI FtpGetCurrentDirectoryA( __in HINTERNET hConnect, __out_ecount(*lpdwCurrentDirectory) LPSTR lpszCurrentDirectory, __inout LPDWORD lpdwCurrentDirectory ); BOOLAPI FtpGetCurrentDirectoryW( __in HINTERNET hConnect, __out_ecount(*lpdwCurrentDirectory) LPWSTR lpszCurrentDirectory, __inout LPDWORD lpdwCurrentDirectory ); #ifdef UNICODE #define FtpGetCurrentDirectory FtpGetCurrentDirectoryW #else #define FtpGetCurrentDirectory FtpGetCurrentDirectoryA #endif // !UNICODE BOOLAPI FtpCommandA( __in HINTERNET hConnect, __in BOOL fExpectResponse, __in DWORD dwFlags, __in LPCSTR lpszCommand, __in_opt DWORD_PTR dwContext, __out_opt HINTERNET *phFtpCommand ); BOOLAPI FtpCommandW( __in HINTERNET hConnect, __in BOOL fExpectResponse, __in DWORD dwFlags, __in LPCWSTR lpszCommand, __in_opt DWORD_PTR dwContext, __out_opt HINTERNET *phFtpCommand ); #ifdef UNICODE #define FtpCommand FtpCommandW #else #define FtpCommand FtpCommandA #endif // !UNICODE INTERNETAPI_(DWORD) FtpGetFileSize( __in HINTERNET hFile, __out_opt LPDWORD lpdwFileSizeHigh ); // // Gopher // // // manifests // // // string field lengths (in characters, not bytes) // #define MAX_GOPHER_DISPLAY_TEXT 128 #define MAX_GOPHER_SELECTOR_TEXT 256 #define MAX_GOPHER_HOST_NAME INTERNET_MAX_HOST_NAME_LENGTH #define MAX_GOPHER_LOCATOR_LENGTH (1 \ + MAX_GOPHER_DISPLAY_TEXT \ + 1 \ + MAX_GOPHER_SELECTOR_TEXT \ + 1 \ + MAX_GOPHER_HOST_NAME \ + 1 \ + INTERNET_MAX_PORT_NUMBER_LENGTH \ + 1 \ + 1 \ + 2 \ ) // // structures/types // // // GOPHER_FIND_DATA - returns the results of a GopherFindFirstFile()/ // InternetFindNextFile() request // typedef struct { CHAR DisplayString[MAX_GOPHER_DISPLAY_TEXT + 1]; DWORD GopherType; // GOPHER_TYPE_, if known DWORD SizeLow; DWORD SizeHigh; FILETIME LastModificationTime; CHAR Locator[MAX_GOPHER_LOCATOR_LENGTH + 1]; } GOPHER_FIND_DATAA, * LPGOPHER_FIND_DATAA; typedef struct { WCHAR DisplayString[MAX_GOPHER_DISPLAY_TEXT + 1]; DWORD GopherType; // GOPHER_TYPE_, if known DWORD SizeLow; DWORD SizeHigh; FILETIME LastModificationTime; WCHAR Locator[MAX_GOPHER_LOCATOR_LENGTH + 1]; } GOPHER_FIND_DATAW, * LPGOPHER_FIND_DATAW; #ifdef UNICODE typedef GOPHER_FIND_DATAW GOPHER_FIND_DATA; typedef LPGOPHER_FIND_DATAW LPGOPHER_FIND_DATA; #else typedef GOPHER_FIND_DATAA GOPHER_FIND_DATA; typedef LPGOPHER_FIND_DATAA LPGOPHER_FIND_DATA; #endif // UNICODE // // manifests for GopherType // #define GOPHER_TYPE_TEXT_FILE 0x00000001 #define GOPHER_TYPE_DIRECTORY 0x00000002 #define GOPHER_TYPE_CSO 0x00000004 #define GOPHER_TYPE_ERROR 0x00000008 #define GOPHER_TYPE_MAC_BINHEX 0x00000010 #define GOPHER_TYPE_DOS_ARCHIVE 0x00000020 #define GOPHER_TYPE_UNIX_UUENCODED 0x00000040 #define GOPHER_TYPE_INDEX_SERVER 0x00000080 #define GOPHER_TYPE_TELNET 0x00000100 #define GOPHER_TYPE_BINARY 0x00000200 #define GOPHER_TYPE_REDUNDANT 0x00000400 #define GOPHER_TYPE_TN3270 0x00000800 #define GOPHER_TYPE_GIF 0x00001000 #define GOPHER_TYPE_IMAGE 0x00002000 #define GOPHER_TYPE_BITMAP 0x00004000 #define GOPHER_TYPE_MOVIE 0x00008000 #define GOPHER_TYPE_SOUND 0x00010000 #define GOPHER_TYPE_HTML 0x00020000 #define GOPHER_TYPE_PDF 0x00040000 #define GOPHER_TYPE_CALENDAR 0x00080000 #define GOPHER_TYPE_INLINE 0x00100000 #define GOPHER_TYPE_UNKNOWN 0x20000000 #define GOPHER_TYPE_ASK 0x40000000 #define GOPHER_TYPE_GOPHER_PLUS 0x80000000 // // gopher type macros // #define IS_GOPHER_FILE(type) (BOOL)(((type) & GOPHER_TYPE_FILE_MASK) ? TRUE : FALSE) #define IS_GOPHER_DIRECTORY(type) (BOOL)(((type) & GOPHER_TYPE_DIRECTORY) ? TRUE : FALSE) #define IS_GOPHER_PHONE_SERVER(type) (BOOL)(((type) & GOPHER_TYPE_CSO) ? TRUE : FALSE) #define IS_GOPHER_ERROR(type) (BOOL)(((type) & GOPHER_TYPE_ERROR) ? TRUE : FALSE) #define IS_GOPHER_INDEX_SERVER(type) (BOOL)(((type) & GOPHER_TYPE_INDEX_SERVER) ? TRUE : FALSE) #define IS_GOPHER_TELNET_SESSION(type) (BOOL)(((type) & GOPHER_TYPE_TELNET) ? TRUE : FALSE) #define IS_GOPHER_BACKUP_SERVER(type) (BOOL)(((type) & GOPHER_TYPE_REDUNDANT) ? TRUE : FALSE) #define IS_GOPHER_TN3270_SESSION(type) (BOOL)(((type) & GOPHER_TYPE_TN3270) ? TRUE : FALSE) #define IS_GOPHER_ASK(type) (BOOL)(((type) & GOPHER_TYPE_ASK) ? TRUE : FALSE) #define IS_GOPHER_PLUS(type) (BOOL)(((type) & GOPHER_TYPE_GOPHER_PLUS) ? TRUE : FALSE) #define IS_GOPHER_TYPE_KNOWN(type) (BOOL)(((type) & GOPHER_TYPE_UNKNOWN) ? FALSE : TRUE) // // GOPHER_TYPE_FILE_MASK - use this to determine if a locator identifies a // (known) file type // #define GOPHER_TYPE_FILE_MASK (GOPHER_TYPE_TEXT_FILE \ | GOPHER_TYPE_MAC_BINHEX \ | GOPHER_TYPE_DOS_ARCHIVE \ | GOPHER_TYPE_UNIX_UUENCODED \ | GOPHER_TYPE_BINARY \ | GOPHER_TYPE_GIF \ | GOPHER_TYPE_IMAGE \ | GOPHER_TYPE_BITMAP \ | GOPHER_TYPE_MOVIE \ | GOPHER_TYPE_SOUND \ | GOPHER_TYPE_HTML \ | GOPHER_TYPE_PDF \ | GOPHER_TYPE_CALENDAR \ | GOPHER_TYPE_INLINE \ ) // // structured gopher attributes (as defined in gopher+ protocol document) // typedef struct { LPCTSTR Comment; LPCTSTR EmailAddress; } GOPHER_ADMIN_ATTRIBUTE_TYPE, * LPGOPHER_ADMIN_ATTRIBUTE_TYPE; typedef struct { FILETIME DateAndTime; } GOPHER_MOD_DATE_ATTRIBUTE_TYPE, * LPGOPHER_MOD_DATE_ATTRIBUTE_TYPE; typedef struct { DWORD Ttl; } GOPHER_TTL_ATTRIBUTE_TYPE, * LPGOPHER_TTL_ATTRIBUTE_TYPE; typedef struct { INT Score; } GOPHER_SCORE_ATTRIBUTE_TYPE, * LPGOPHER_SCORE_ATTRIBUTE_TYPE; typedef struct { INT LowerBound; INT UpperBound; } GOPHER_SCORE_RANGE_ATTRIBUTE_TYPE, * LPGOPHER_SCORE_RANGE_ATTRIBUTE_TYPE; typedef struct { LPCTSTR Site; } GOPHER_SITE_ATTRIBUTE_TYPE, * LPGOPHER_SITE_ATTRIBUTE_TYPE; typedef struct { LPCTSTR Organization; } GOPHER_ORGANIZATION_ATTRIBUTE_TYPE, * LPGOPHER_ORGANIZATION_ATTRIBUTE_TYPE; typedef struct { LPCTSTR Location; } GOPHER_LOCATION_ATTRIBUTE_TYPE, * LPGOPHER_LOCATION_ATTRIBUTE_TYPE; typedef struct { INT DegreesNorth; INT MinutesNorth; INT SecondsNorth; INT DegreesEast; INT MinutesEast; INT SecondsEast; } GOPHER_GEOGRAPHICAL_LOCATION_ATTRIBUTE_TYPE, * LPGOPHER_GEOGRAPHICAL_LOCATION_ATTRIBUTE_TYPE; typedef struct { INT Zone; } GOPHER_TIMEZONE_ATTRIBUTE_TYPE, * LPGOPHER_TIMEZONE_ATTRIBUTE_TYPE; typedef struct { LPCTSTR Provider; } GOPHER_PROVIDER_ATTRIBUTE_TYPE, * LPGOPHER_PROVIDER_ATTRIBUTE_TYPE; typedef struct { LPCTSTR Version; } GOPHER_VERSION_ATTRIBUTE_TYPE, * LPGOPHER_VERSION_ATTRIBUTE_TYPE; typedef struct { LPCTSTR ShortAbstract; LPCTSTR AbstractFile; } GOPHER_ABSTRACT_ATTRIBUTE_TYPE, * LPGOPHER_ABSTRACT_ATTRIBUTE_TYPE; typedef struct { LPCTSTR ContentType; LPCTSTR Language; DWORD Size; } GOPHER_VIEW_ATTRIBUTE_TYPE, * LPGOPHER_VIEW_ATTRIBUTE_TYPE; typedef struct { BOOL TreeWalk; } GOPHER_VERONICA_ATTRIBUTE_TYPE, * LPGOPHER_VERONICA_ATTRIBUTE_TYPE; typedef struct { LPCTSTR QuestionType; LPCTSTR QuestionText; } GOPHER_ASK_ATTRIBUTE_TYPE, * LPGOPHER_ASK_ATTRIBUTE_TYPE; // // GOPHER_UNKNOWN_ATTRIBUTE_TYPE - this is returned if we retrieve an attribute // that is not specified in the current gopher/gopher+ documentation. It is up // to the application to parse the information // typedef struct { LPCTSTR Text; } GOPHER_UNKNOWN_ATTRIBUTE_TYPE, * LPGOPHER_UNKNOWN_ATTRIBUTE_TYPE; // // GOPHER_ATTRIBUTE_TYPE - returned in the user's buffer when an enumerated // GopherGetAttribute call is made // typedef struct { DWORD CategoryId; // e.g. GOPHER_CATEGORY_ID_ADMIN DWORD AttributeId; // e.g. GOPHER_ATTRIBUTE_ID_ADMIN union { GOPHER_ADMIN_ATTRIBUTE_TYPE Admin; GOPHER_MOD_DATE_ATTRIBUTE_TYPE ModDate; GOPHER_TTL_ATTRIBUTE_TYPE Ttl; GOPHER_SCORE_ATTRIBUTE_TYPE Score; GOPHER_SCORE_RANGE_ATTRIBUTE_TYPE ScoreRange; GOPHER_SITE_ATTRIBUTE_TYPE Site; GOPHER_ORGANIZATION_ATTRIBUTE_TYPE Organization; GOPHER_LOCATION_ATTRIBUTE_TYPE Location; GOPHER_GEOGRAPHICAL_LOCATION_ATTRIBUTE_TYPE GeographicalLocation; GOPHER_TIMEZONE_ATTRIBUTE_TYPE TimeZone; GOPHER_PROVIDER_ATTRIBUTE_TYPE Provider; GOPHER_VERSION_ATTRIBUTE_TYPE Version; GOPHER_ABSTRACT_ATTRIBUTE_TYPE Abstract; GOPHER_VIEW_ATTRIBUTE_TYPE View; GOPHER_VERONICA_ATTRIBUTE_TYPE Veronica; GOPHER_ASK_ATTRIBUTE_TYPE Ask; GOPHER_UNKNOWN_ATTRIBUTE_TYPE Unknown; } AttributeType; } GOPHER_ATTRIBUTE_TYPE, * LPGOPHER_ATTRIBUTE_TYPE; #define MAX_GOPHER_CATEGORY_NAME 128 // arbitrary #define MAX_GOPHER_ATTRIBUTE_NAME 128 // " #define MIN_GOPHER_ATTRIBUTE_LENGTH 256 // " // // known gopher attribute categories. See below for ordinals // #define GOPHER_INFO_CATEGORY TEXT("+INFO") #define GOPHER_ADMIN_CATEGORY TEXT("+ADMIN") #define GOPHER_VIEWS_CATEGORY TEXT("+VIEWS") #define GOPHER_ABSTRACT_CATEGORY TEXT("+ABSTRACT") #define GOPHER_VERONICA_CATEGORY TEXT("+VERONICA") // // known gopher attributes. These are the attribute names as defined in the // gopher+ protocol document // #define GOPHER_ADMIN_ATTRIBUTE TEXT("Admin") #define GOPHER_MOD_DATE_ATTRIBUTE TEXT("Mod-Date") #define GOPHER_TTL_ATTRIBUTE TEXT("TTL") #define GOPHER_SCORE_ATTRIBUTE TEXT("Score") #define GOPHER_RANGE_ATTRIBUTE TEXT("Score-range") #define GOPHER_SITE_ATTRIBUTE TEXT("Site") #define GOPHER_ORG_ATTRIBUTE TEXT("Org") #define GOPHER_LOCATION_ATTRIBUTE TEXT("Loc") #define GOPHER_GEOG_ATTRIBUTE TEXT("Geog") #define GOPHER_TIMEZONE_ATTRIBUTE TEXT("TZ") #define GOPHER_PROVIDER_ATTRIBUTE TEXT("Provider") #define GOPHER_VERSION_ATTRIBUTE TEXT("Version") #define GOPHER_ABSTRACT_ATTRIBUTE TEXT("Abstract") #define GOPHER_VIEW_ATTRIBUTE TEXT("View") #define GOPHER_TREEWALK_ATTRIBUTE TEXT("treewalk") // // identifiers for attribute strings // #define GOPHER_ATTRIBUTE_ID_BASE 0xabcccc00 #define GOPHER_CATEGORY_ID_ALL (GOPHER_ATTRIBUTE_ID_BASE + 1) #define GOPHER_CATEGORY_ID_INFO (GOPHER_ATTRIBUTE_ID_BASE + 2) #define GOPHER_CATEGORY_ID_ADMIN (GOPHER_ATTRIBUTE_ID_BASE + 3) #define GOPHER_CATEGORY_ID_VIEWS (GOPHER_ATTRIBUTE_ID_BASE + 4) #define GOPHER_CATEGORY_ID_ABSTRACT (GOPHER_ATTRIBUTE_ID_BASE + 5) #define GOPHER_CATEGORY_ID_VERONICA (GOPHER_ATTRIBUTE_ID_BASE + 6) #define GOPHER_CATEGORY_ID_ASK (GOPHER_ATTRIBUTE_ID_BASE + 7) #define GOPHER_CATEGORY_ID_UNKNOWN (GOPHER_ATTRIBUTE_ID_BASE + 8) #define GOPHER_ATTRIBUTE_ID_ALL (GOPHER_ATTRIBUTE_ID_BASE + 9) #define GOPHER_ATTRIBUTE_ID_ADMIN (GOPHER_ATTRIBUTE_ID_BASE + 10) #define GOPHER_ATTRIBUTE_ID_MOD_DATE (GOPHER_ATTRIBUTE_ID_BASE + 11) #define GOPHER_ATTRIBUTE_ID_TTL (GOPHER_ATTRIBUTE_ID_BASE + 12) #define GOPHER_ATTRIBUTE_ID_SCORE (GOPHER_ATTRIBUTE_ID_BASE + 13) #define GOPHER_ATTRIBUTE_ID_RANGE (GOPHER_ATTRIBUTE_ID_BASE + 14) #define GOPHER_ATTRIBUTE_ID_SITE (GOPHER_ATTRIBUTE_ID_BASE + 15) #define GOPHER_ATTRIBUTE_ID_ORG (GOPHER_ATTRIBUTE_ID_BASE + 16) #define GOPHER_ATTRIBUTE_ID_LOCATION (GOPHER_ATTRIBUTE_ID_BASE + 17) #define GOPHER_ATTRIBUTE_ID_GEOG (GOPHER_ATTRIBUTE_ID_BASE + 18) #define GOPHER_ATTRIBUTE_ID_TIMEZONE (GOPHER_ATTRIBUTE_ID_BASE + 19) #define GOPHER_ATTRIBUTE_ID_PROVIDER (GOPHER_ATTRIBUTE_ID_BASE + 20) #define GOPHER_ATTRIBUTE_ID_VERSION (GOPHER_ATTRIBUTE_ID_BASE + 21) #define GOPHER_ATTRIBUTE_ID_ABSTRACT (GOPHER_ATTRIBUTE_ID_BASE + 22) #define GOPHER_ATTRIBUTE_ID_VIEW (GOPHER_ATTRIBUTE_ID_BASE + 23) #define GOPHER_ATTRIBUTE_ID_TREEWALK (GOPHER_ATTRIBUTE_ID_BASE + 24) #define GOPHER_ATTRIBUTE_ID_UNKNOWN (GOPHER_ATTRIBUTE_ID_BASE + 25) // // prototypes // BOOLAPI GopherCreateLocatorA( __in LPCSTR lpszHost, __in INTERNET_PORT nServerPort, __in_opt LPCSTR lpszDisplayString, __in_opt LPCSTR lpszSelectorString, __in DWORD dwGopherType, __out_ecount_opt(*lpdwBufferLength) LPSTR lpszLocator, __inout LPDWORD lpdwBufferLength ); BOOLAPI GopherCreateLocatorW( __in LPCWSTR lpszHost, __in INTERNET_PORT nServerPort, __in_opt LPCWSTR lpszDisplayString, __in_opt LPCWSTR lpszSelectorString, __in DWORD dwGopherType, __out_ecount_opt(*lpdwBufferLength) LPWSTR lpszLocator, __inout LPDWORD lpdwBufferLength ); #ifdef UNICODE #define GopherCreateLocator GopherCreateLocatorW #else #define GopherCreateLocator GopherCreateLocatorA #endif // !UNICODE BOOLAPI GopherGetLocatorTypeA( __in LPCSTR lpszLocator, __out LPDWORD lpdwGopherType ); BOOLAPI GopherGetLocatorTypeW( __in LPCWSTR lpszLocator, __out LPDWORD lpdwGopherType ); #ifdef UNICODE #define GopherGetLocatorType GopherGetLocatorTypeW #else #define GopherGetLocatorType GopherGetLocatorTypeA #endif // !UNICODE INTERNETAPI_(HINTERNET) GopherFindFirstFileA( __in HINTERNET hConnect, __in_opt LPCSTR lpszLocator, __in_opt LPCSTR lpszSearchString, __out_opt LPGOPHER_FIND_DATAA lpFindData, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(HINTERNET) GopherFindFirstFileW( __in HINTERNET hConnect, __in_opt LPCWSTR lpszLocator, __in_opt LPCWSTR lpszSearchString, __out_opt LPGOPHER_FIND_DATAW lpFindData, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define GopherFindFirstFile GopherFindFirstFileW #else #define GopherFindFirstFile GopherFindFirstFileA #endif // !UNICODE INTERNETAPI_(HINTERNET) GopherOpenFileA( __in HINTERNET hConnect, __in LPCSTR lpszLocator, __in_opt LPCSTR lpszView, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(HINTERNET) GopherOpenFileW( __in HINTERNET hConnect, __in LPCWSTR lpszLocator, __in_opt LPCWSTR lpszView, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define GopherOpenFile GopherOpenFileW #else #define GopherOpenFile GopherOpenFileA #endif // !UNICODE typedef BOOL (CALLBACK * GOPHER_ATTRIBUTE_ENUMERATOR)( __in LPGOPHER_ATTRIBUTE_TYPE lpAttributeInfo, __in DWORD dwError ); BOOLAPI GopherGetAttributeA( __in HINTERNET hConnect, __in LPCSTR lpszLocator, __in_opt LPCSTR lpszAttributeName, __out_ecount(dwBufferLength) __typefix(LPTSTR) LPBYTE lpBuffer, __in DWORD dwBufferLength, __out LPDWORD lpdwCharactersReturned, __in_opt GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator, __in_opt DWORD_PTR dwContext ); BOOLAPI GopherGetAttributeW( __in HINTERNET hConnect, __in LPCWSTR lpszLocator, __in_opt LPCWSTR lpszAttributeName, __out_ecount(dwBufferLength) __typefix(LPTSTR) LPBYTE lpBuffer, __in DWORD dwBufferLength, __out LPDWORD lpdwCharactersReturned, __in_opt GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define GopherGetAttribute GopherGetAttributeW #else #define GopherGetAttribute GopherGetAttributeA #endif // !UNICODE // // HTTP // // // manifests // // // the default major/minor HTTP version numbers // #define HTTP_MAJOR_VERSION 1 #define HTTP_MINOR_VERSION 0 #define HTTP_VERSIONA "HTTP/1.0" #define HTTP_VERSIONW L"HTTP/1.0" #ifdef UNICODE #define HTTP_VERSION HTTP_VERSIONW #else #define HTTP_VERSION HTTP_VERSIONA #endif // // HttpQueryInfo info levels. Generally, there is one info level // for each potential RFC822/HTTP/MIME header that an HTTP server // may send as part of a request response. // // The HTTP_QUERY_RAW_HEADERS info level is provided for clients // that choose to perform their own header parsing. // #define HTTP_QUERY_MIME_VERSION 0 #define HTTP_QUERY_CONTENT_TYPE 1 #define HTTP_QUERY_CONTENT_TRANSFER_ENCODING 2 #define HTTP_QUERY_CONTENT_ID 3 #define HTTP_QUERY_CONTENT_DESCRIPTION 4 #define HTTP_QUERY_CONTENT_LENGTH 5 #define HTTP_QUERY_CONTENT_LANGUAGE 6 #define HTTP_QUERY_ALLOW 7 #define HTTP_QUERY_PUBLIC 8 #define HTTP_QUERY_DATE 9 #define HTTP_QUERY_EXPIRES 10 #define HTTP_QUERY_LAST_MODIFIED 11 #define HTTP_QUERY_MESSAGE_ID 12 #define HTTP_QUERY_URI 13 #define HTTP_QUERY_DERIVED_FROM 14 #define HTTP_QUERY_COST 15 #define HTTP_QUERY_LINK 16 #define HTTP_QUERY_PRAGMA 17 #define HTTP_QUERY_VERSION 18 // special: part of status line #define HTTP_QUERY_STATUS_CODE 19 // special: part of status line #define HTTP_QUERY_STATUS_TEXT 20 // special: part of status line #define HTTP_QUERY_RAW_HEADERS 21 // special: all headers as ASCIIZ #define HTTP_QUERY_RAW_HEADERS_CRLF 22 // special: all headers #define HTTP_QUERY_CONNECTION 23 #define HTTP_QUERY_ACCEPT 24 #define HTTP_QUERY_ACCEPT_CHARSET 25 #define HTTP_QUERY_ACCEPT_ENCODING 26 #define HTTP_QUERY_ACCEPT_LANGUAGE 27 #define HTTP_QUERY_AUTHORIZATION 28 #define HTTP_QUERY_CONTENT_ENCODING 29 #define HTTP_QUERY_FORWARDED 30 #define HTTP_QUERY_FROM 31 #define HTTP_QUERY_IF_MODIFIED_SINCE 32 #define HTTP_QUERY_LOCATION 33 #define HTTP_QUERY_ORIG_URI 34 #define HTTP_QUERY_REFERER 35 #define HTTP_QUERY_RETRY_AFTER 36 #define HTTP_QUERY_SERVER 37 #define HTTP_QUERY_TITLE 38 #define HTTP_QUERY_USER_AGENT 39 #define HTTP_QUERY_WWW_AUTHENTICATE 40 #define HTTP_QUERY_PROXY_AUTHENTICATE 41 #define HTTP_QUERY_ACCEPT_RANGES 42 #define HTTP_QUERY_SET_COOKIE 43 #define HTTP_QUERY_COOKIE 44 #define HTTP_QUERY_REQUEST_METHOD 45 // special: GET/POST etc. #define HTTP_QUERY_REFRESH 46 #define HTTP_QUERY_CONTENT_DISPOSITION 47 // // HTTP 1.1 defined headers // #define HTTP_QUERY_AGE 48 #define HTTP_QUERY_CACHE_CONTROL 49 #define HTTP_QUERY_CONTENT_BASE 50 #define HTTP_QUERY_CONTENT_LOCATION 51 #define HTTP_QUERY_CONTENT_MD5 52 #define HTTP_QUERY_CONTENT_RANGE 53 #define HTTP_QUERY_ETAG 54 #define HTTP_QUERY_HOST 55 #define HTTP_QUERY_IF_MATCH 56 #define HTTP_QUERY_IF_NONE_MATCH 57 #define HTTP_QUERY_IF_RANGE 58 #define HTTP_QUERY_IF_UNMODIFIED_SINCE 59 #define HTTP_QUERY_MAX_FORWARDS 60 #define HTTP_QUERY_PROXY_AUTHORIZATION 61 #define HTTP_QUERY_RANGE 62 #define HTTP_QUERY_TRANSFER_ENCODING 63 #define HTTP_QUERY_UPGRADE 64 #define HTTP_QUERY_VARY 65 #define HTTP_QUERY_VIA 66 #define HTTP_QUERY_WARNING 67 #define HTTP_QUERY_EXPECT 68 #define HTTP_QUERY_PROXY_CONNECTION 69 #define HTTP_QUERY_UNLESS_MODIFIED_SINCE 70 #define HTTP_QUERY_ECHO_REQUEST 71 #define HTTP_QUERY_ECHO_REPLY 72 // These are the set of headers that should be added back to a request when // re-doing a request after a RETRY_WITH response. #define HTTP_QUERY_ECHO_HEADERS 73 #define HTTP_QUERY_ECHO_HEADERS_CRLF 74 #define HTTP_QUERY_PROXY_SUPPORT 75 #define HTTP_QUERY_AUTHENTICATION_INFO 76 #define HTTP_QUERY_PASSPORT_URLS 77 #define HTTP_QUERY_PASSPORT_CONFIG 78 #define HTTP_QUERY_MAX 78 // // HTTP_QUERY_CUSTOM - if this special value is supplied as the dwInfoLevel // parameter of HttpQueryInfo() then the lpBuffer parameter contains the name // of the header we are to query // #define HTTP_QUERY_CUSTOM 65535 // // HTTP_QUERY_FLAG_REQUEST_HEADERS - if this bit is set in the dwInfoLevel // parameter of HttpQueryInfo() then the request headers will be queried for the // request information // #define HTTP_QUERY_FLAG_REQUEST_HEADERS 0x80000000 // // HTTP_QUERY_FLAG_SYSTEMTIME - if this bit is set in the dwInfoLevel parameter // of HttpQueryInfo() AND the header being queried contains date information, // e.g. the "Expires:" header then lpBuffer will contain a SYSTEMTIME structure // containing the date and time information converted from the header string // #define HTTP_QUERY_FLAG_SYSTEMTIME 0x40000000 // // HTTP_QUERY_FLAG_NUMBER - if this bit is set in the dwInfoLevel parameter of // HttpQueryInfo(), then the value of the header will be converted to a 32bit // number before being returned to the caller, if applicable // #define HTTP_QUERY_FLAG_NUMBER 0x20000000 // // HTTP_QUERY_FLAG_COALESCE - combine the values from several headers of the // same name into the output buffer // #define HTTP_QUERY_FLAG_COALESCE 0x10000000 // // HTTP_QUERY_FLAG_NUMBER64 - if this bit is set in the dwInfoLevel parameter of // HttpQueryInfo(), then the value of the header will be converted to a 64bit // number before being returned to the caller, if applicable // #define HTTP_QUERY_FLAG_NUMBER64 0x08000000 #define HTTP_QUERY_MODIFIER_FLAGS_MASK (HTTP_QUERY_FLAG_REQUEST_HEADERS \ | HTTP_QUERY_FLAG_SYSTEMTIME \ | HTTP_QUERY_FLAG_NUMBER \ | HTTP_QUERY_FLAG_COALESCE \ | HTTP_QUERY_FLAG_NUMBER64 \ ) #define HTTP_QUERY_HEADER_MASK (~HTTP_QUERY_MODIFIER_FLAGS_MASK) // // HTTP Response Status Codes: // #define HTTP_STATUS_CONTINUE 100 // OK to continue with request #define HTTP_STATUS_SWITCH_PROTOCOLS 101 // server has switched protocols in upgrade header #define HTTP_STATUS_OK 200 // request completed #define HTTP_STATUS_CREATED 201 // object created, reason = new URI #define HTTP_STATUS_ACCEPTED 202 // async completion (TBS) #define HTTP_STATUS_PARTIAL 203 // partial completion #define HTTP_STATUS_NO_CONTENT 204 // no info to return #define HTTP_STATUS_RESET_CONTENT 205 // request completed, but clear form #define HTTP_STATUS_PARTIAL_CONTENT 206 // partial GET furfilled #define HTTP_STATUS_AMBIGUOUS 300 // server couldn't decide what to return #define HTTP_STATUS_MOVED 301 // object permanently moved #define HTTP_STATUS_REDIRECT 302 // object temporarily moved #define HTTP_STATUS_REDIRECT_METHOD 303 // redirection w/ new access method #define HTTP_STATUS_NOT_MODIFIED 304 // if-modified-since was not modified #define HTTP_STATUS_USE_PROXY 305 // redirection to proxy, location header specifies proxy to use #define HTTP_STATUS_REDIRECT_KEEP_VERB 307 // HTTP/1.1: keep same verb #define HTTP_STATUS_BAD_REQUEST 400 // invalid syntax #define HTTP_STATUS_DENIED 401 // access denied #define HTTP_STATUS_PAYMENT_REQ 402 // payment required #define HTTP_STATUS_FORBIDDEN 403 // request forbidden #define HTTP_STATUS_NOT_FOUND 404 // object not found #define HTTP_STATUS_BAD_METHOD 405 // method is not allowed #define HTTP_STATUS_NONE_ACCEPTABLE 406 // no response acceptable to client found #define HTTP_STATUS_PROXY_AUTH_REQ 407 // proxy authentication required #define HTTP_STATUS_REQUEST_TIMEOUT 408 // server timed out waiting for request #define HTTP_STATUS_CONFLICT 409 // user should resubmit with more info #define HTTP_STATUS_GONE 410 // the resource is no longer available #define HTTP_STATUS_LENGTH_REQUIRED 411 // the server refused to accept request w/o a length #define HTTP_STATUS_PRECOND_FAILED 412 // precondition given in request failed #define HTTP_STATUS_REQUEST_TOO_LARGE 413 // request entity was too large #define HTTP_STATUS_URI_TOO_LONG 414 // request URI too long #define HTTP_STATUS_UNSUPPORTED_MEDIA 415 // unsupported media type #define HTTP_STATUS_RETRY_WITH 449 // retry after doing the appropriate action. #define HTTP_STATUS_SERVER_ERROR 500 // internal server error #define HTTP_STATUS_NOT_SUPPORTED 501 // required not supported #define HTTP_STATUS_BAD_GATEWAY 502 // error response received from gateway #define HTTP_STATUS_SERVICE_UNAVAIL 503 // temporarily overloaded #define HTTP_STATUS_GATEWAY_TIMEOUT 504 // timed out waiting for gateway #define HTTP_STATUS_VERSION_NOT_SUP 505 // HTTP version not supported #define HTTP_STATUS_FIRST HTTP_STATUS_CONTINUE #define HTTP_STATUS_LAST HTTP_STATUS_VERSION_NOT_SUP // // prototypes // INTERNETAPI_(HINTERNET) HttpOpenRequestA( __in HINTERNET hConnect, __in_opt LPCSTR lpszVerb, __in_opt LPCSTR lpszObjectName, __in_opt LPCSTR lpszVersion, __in_opt LPCSTR lpszReferrer, __in_z_opt LPCSTR FAR * lplpszAcceptTypes, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(HINTERNET) HttpOpenRequestW( __in HINTERNET hConnect, __in_opt LPCWSTR lpszVerb, __in_opt LPCWSTR lpszObjectName, __in_opt LPCWSTR lpszVersion, __in_opt LPCWSTR lpszReferrer, __in_z_opt LPCWSTR FAR * lplpszAcceptTypes, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define HttpOpenRequest HttpOpenRequestW #else #define HttpOpenRequest HttpOpenRequestA #endif // !UNICODE BOOLAPI HttpAddRequestHeadersA( __in HINTERNET hRequest, __in_ecount(dwHeadersLength) LPCSTR lpszHeaders, __in DWORD dwHeadersLength, __in DWORD dwModifiers ); BOOLAPI HttpAddRequestHeadersW( __in HINTERNET hRequest, __in_ecount(dwHeadersLength) LPCWSTR lpszHeaders, __in DWORD dwHeadersLength, __in DWORD dwModifiers ); #ifdef UNICODE #define HttpAddRequestHeaders HttpAddRequestHeadersW #else #define HttpAddRequestHeaders HttpAddRequestHeadersA #endif // !UNICODE // // values for dwModifiers parameter of HttpAddRequestHeaders() // #define HTTP_ADDREQ_INDEX_MASK 0x0000FFFF #define HTTP_ADDREQ_FLAGS_MASK 0xFFFF0000 // // HTTP_ADDREQ_FLAG_ADD_IF_NEW - the header will only be added if it doesn't // already exist // #define HTTP_ADDREQ_FLAG_ADD_IF_NEW 0x10000000 // // HTTP_ADDREQ_FLAG_ADD - if HTTP_ADDREQ_FLAG_REPLACE is set but the header is // not found then if this flag is set, the header is added anyway, so long as // there is a valid header-value // #define HTTP_ADDREQ_FLAG_ADD 0x20000000 // // HTTP_ADDREQ_FLAG_COALESCE - coalesce headers with same name. e.g. // "Accept: text/*" and "Accept: audio/*" with this flag results in a single // header: "Accept: text/*, audio/*" // #define HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA 0x40000000 #define HTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON 0x01000000 #define HTTP_ADDREQ_FLAG_COALESCE HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA // // HTTP_ADDREQ_FLAG_REPLACE - replaces the specified header. Only one header can // be supplied in the buffer. If the header to be replaced is not the first // in a list of headers with the same name, then the relative index should be // supplied in the low 8 bits of the dwModifiers parameter. If the header-value // part is missing, then the header is removed // #define HTTP_ADDREQ_FLAG_REPLACE 0x80000000 BOOLAPI HttpSendRequestA( __in HINTERNET hRequest, __in_ecount_opt(dwHeadersLength) LPCSTR lpszHeaders, __in DWORD dwHeadersLength, __in_bcount_opt(dwOptionalLength) LPVOID lpOptional, __in DWORD dwOptionalLength ); BOOLAPI HttpSendRequestW( __in HINTERNET hRequest, __in_ecount_opt(dwHeadersLength) LPCWSTR lpszHeaders, __in DWORD dwHeadersLength, __in_bcount_opt(dwOptionalLength) LPVOID lpOptional, __in DWORD dwOptionalLength ); #ifdef UNICODE #define HttpSendRequest HttpSendRequestW #else #define HttpSendRequest HttpSendRequestA #endif // !UNICODE INTERNETAPI_(BOOL) HttpSendRequestExA( __in HINTERNET hRequest, __in_opt LPINTERNET_BUFFERSA lpBuffersIn, __out_opt LPINTERNET_BUFFERSA lpBuffersOut, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(BOOL) HttpSendRequestExW( __in HINTERNET hRequest, __in_opt LPINTERNET_BUFFERSW lpBuffersIn, __out_opt LPINTERNET_BUFFERSW lpBuffersOut, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define HttpSendRequestEx HttpSendRequestExW #else #define HttpSendRequestEx HttpSendRequestExA #endif // !UNICODE // // flags for HttpSendRequestEx(), HttpEndRequest() // #define HSR_ASYNC WININET_API_FLAG_ASYNC // force async #define HSR_SYNC WININET_API_FLAG_SYNC // force sync #define HSR_USE_CONTEXT WININET_API_FLAG_USE_CONTEXT // use dwContext value #define HSR_INITIATE 0x00000008 // iterative operation (completed by HttpEndRequest) #define HSR_DOWNLOAD 0x00000010 // download to file #define HSR_CHUNKED 0x00000020 // operation is send of chunked data INTERNETAPI_(BOOL) HttpEndRequestA( __in HINTERNET hRequest, __out_opt LPINTERNET_BUFFERSA lpBuffersOut, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); INTERNETAPI_(BOOL) HttpEndRequestW( __in HINTERNET hRequest, __out_opt LPINTERNET_BUFFERSW lpBuffersOut, __in DWORD dwFlags, __in_opt DWORD_PTR dwContext ); #ifdef UNICODE #define HttpEndRequest HttpEndRequestW #else #define HttpEndRequest HttpEndRequestA #endif // !UNICODE BOOLAPI HttpQueryInfoA( __in HINTERNET hRequest, __in DWORD dwInfoLevel, __inout_bcount_opt(*lpdwBufferLength) __out_data_source(NETWORK) LPVOID lpBuffer, __inout LPDWORD lpdwBufferLength, __inout_opt LPDWORD lpdwIndex ); BOOLAPI HttpQueryInfoW( __in HINTERNET hRequest, __in DWORD dwInfoLevel, __inout_bcount_opt(*lpdwBufferLength) __out_data_source(NETWORK) LPVOID lpBuffer, __inout LPDWORD lpdwBufferLength, __inout_opt LPDWORD lpdwIndex ); #ifdef UNICODE #define HttpQueryInfo HttpQueryInfoW #else #define HttpQueryInfo HttpQueryInfoA #endif // !UNICODE // // Cookie APIs // #define INTERNET_COOKIE_IS_SECURE 0x01 #define INTERNET_COOKIE_IS_SESSION 0x02 #define INTERNET_COOKIE_THIRD_PARTY 0x10 #define INTERNET_COOKIE_PROMPT_REQUIRED 0x20 #define INTERNET_COOKIE_EVALUATE_P3P 0x40 #define INTERNET_COOKIE_APPLY_P3P 0x80 #define INTERNET_COOKIE_P3P_ENABLED 0x100 #define INTERNET_COOKIE_IS_RESTRICTED 0x200 #define INTERNET_COOKIE_IE6 0x400 #define INTERNET_COOKIE_IS_LEGACY 0x800 #define INTERNET_COOKIE_NON_SCRIPT 0x00001000 #define INTERNET_COOKIE_HTTPONLY 0x00002000 BOOLAPI InternetSetCookieA( __in LPCSTR lpszUrl, __in_opt LPCSTR lpszCookieName, __in LPCSTR lpszCookieData ); BOOLAPI InternetSetCookieW( __in LPCWSTR lpszUrl, __in_opt LPCWSTR lpszCookieName, __in LPCWSTR lpszCookieData ); #ifdef UNICODE #define InternetSetCookie InternetSetCookieW #else #define InternetSetCookie InternetSetCookieA #endif // !UNICODE BOOLAPI InternetGetCookieA( __in LPCSTR lpszUrl, __in_opt LPCSTR lpszCookieName, __out_ecount_opt(*lpdwSize) LPSTR lpszCookieData, __inout LPDWORD lpdwSize ); BOOLAPI InternetGetCookieW( __in LPCWSTR lpszUrl, __in_opt LPCWSTR lpszCookieName, __out_ecount_opt(*lpdwSize) LPWSTR lpszCookieData, __inout LPDWORD lpdwSize ); #ifdef UNICODE #define InternetGetCookie InternetGetCookieW #else #define InternetGetCookie InternetGetCookieA #endif // !UNICODE INTERNETAPI_(DWORD) InternetSetCookieExA( __in LPCSTR lpszUrl, __in_opt LPCSTR lpszCookieName, __in LPCSTR lpszCookieData, __in DWORD dwFlags, __in_opt DWORD_PTR dwReserved ); INTERNETAPI_(DWORD) InternetSetCookieExW( __in LPCWSTR lpszUrl, __in_opt LPCWSTR lpszCookieName, __in LPCWSTR lpszCookieData, __in DWORD dwFlags, __in_opt DWORD_PTR dwReserved ); #ifdef UNICODE #define InternetSetCookieEx InternetSetCookieExW #else #define InternetSetCookieEx InternetSetCookieExA #endif // !UNICODE BOOLAPI InternetGetCookieExA( __in LPCSTR lpszUrl, __in_opt LPCSTR lpszCookieName, __in_ecount_opt(*lpdwSize) LPSTR lpszCookieData, __inout LPDWORD lpdwSize, __in DWORD dwFlags, __reserved LPVOID lpReserved ); BOOLAPI InternetGetCookieExW( __in LPCWSTR lpszUrl, __in_opt LPCWSTR lpszCookieName, __in_ecount_opt(*lpdwSize) LPWSTR lpszCookieData, __inout LPDWORD lpdwSize, __in DWORD dwFlags, __reserved LPVOID lpReserved ); #ifdef UNICODE #define InternetGetCookieEx InternetGetCookieExW #else #define InternetGetCookieEx InternetGetCookieExA #endif // !UNICODE // // offline browsing // INTERNETAPI_(DWORD) InternetAttemptConnect( __in DWORD dwReserved ); BOOLAPI InternetCheckConnectionA( __in LPCSTR lpszUrl, __in DWORD dwFlags, __in DWORD dwReserved ); BOOLAPI InternetCheckConnectionW( __in LPCWSTR lpszUrl, __in DWORD dwFlags, __in DWORD dwReserved ); #ifdef UNICODE #define InternetCheckConnection InternetCheckConnectionW #else #define InternetCheckConnection InternetCheckConnectionA #endif // !UNICODE #define FLAG_ICC_FORCE_CONNECTION 0x00000001 // // Internet UI // // // InternetErrorDlg - Provides UI for certain Errors. // #define FLAGS_ERROR_UI_FILTER_FOR_ERRORS 0x01 #define FLAGS_ERROR_UI_FLAGS_CHANGE_OPTIONS 0x02 #define FLAGS_ERROR_UI_FLAGS_GENERATE_DATA 0x04 #define FLAGS_ERROR_UI_FLAGS_NO_UI 0x08 #define FLAGS_ERROR_UI_SERIALIZE_DIALOGS 0x10 // // If SERIALIZE_DIALOGS flag set, client should implement thread-safe non-blocking callback... // DWORD InternetAuthNotifyCallback ( DWORD_PTR dwContext, // as passed to InternetErrorDlg DWORD dwReturn, // error code: success, resend, or cancel LPVOID lpReserved // reserved: will be set to null ); typedef DWORD (CALLBACK * PFN_AUTH_NOTIFY) (DWORD_PTR, DWORD, LPVOID); // // ... and last parameter of InternetErrorDlg should point to... // typedef struct { DWORD cbStruct; // size of this structure DWORD dwOptions; // reserved: must set to 0 PFN_AUTH_NOTIFY pfnNotify; // notification callback to retry InternetErrorDlg DWORD_PTR dwContext; // context to pass to to notification function } INTERNET_AUTH_NOTIFY_DATA; INTERNETAPI_(BOOL) ResumeSuspendedDownload( __in HINTERNET hRequest, __in DWORD dwResultCode ); INTERNETAPI_(DWORD) InternetErrorDlg( __in HWND hWnd, __inout_opt HINTERNET hRequest, __in DWORD dwError, __in DWORD dwFlags, __inout_opt LPVOID * lppvData ); INTERNETAPI_(DWORD) InternetConfirmZoneCrossingA( __in HWND hWnd, __in LPSTR szUrlPrev, __in LPSTR szUrlNew, __in BOOL bPost ); INTERNETAPI_(DWORD) InternetConfirmZoneCrossingW( __in HWND hWnd, __in LPWSTR szUrlPrev, __in LPWSTR szUrlNew, __in BOOL bPost ); #ifdef UNICODE #define InternetConfirmZoneCrossing InternetConfirmZoneCrossingW #else #ifdef _WINX32_ #define InternetConfirmZoneCrossing InternetConfirmZoneCrossingA #else INTERNETAPI_(DWORD) InternetConfirmZoneCrossing( __in HWND hWnd, __in LPSTR szUrlPrev, __in LPSTR szUrlNew, __in BOOL bPost ); #endif // _WINX32_ #endif // !UNICODE //#if !defined(_WINERROR_) // // Internet API error returns // #define INTERNET_ERROR_BASE 12000 #define ERROR_INTERNET_OUT_OF_HANDLES (INTERNET_ERROR_BASE + 1) #define ERROR_INTERNET_TIMEOUT (INTERNET_ERROR_BASE + 2) #define ERROR_INTERNET_EXTENDED_ERROR (INTERNET_ERROR_BASE + 3) #define ERROR_INTERNET_INTERNAL_ERROR (INTERNET_ERROR_BASE + 4) #define ERROR_INTERNET_INVALID_URL (INTERNET_ERROR_BASE + 5) #define ERROR_INTERNET_UNRECOGNIZED_SCHEME (INTERNET_ERROR_BASE + 6) #define ERROR_INTERNET_NAME_NOT_RESOLVED (INTERNET_ERROR_BASE + 7) #define ERROR_INTERNET_PROTOCOL_NOT_FOUND (INTERNET_ERROR_BASE + 8) #define ERROR_INTERNET_INVALID_OPTION (INTERNET_ERROR_BASE + 9) #define ERROR_INTERNET_BAD_OPTION_LENGTH (INTERNET_ERROR_BASE + 10) #define ERROR_INTERNET_OPTION_NOT_SETTABLE (INTERNET_ERROR_BASE + 11) #define ERROR_INTERNET_SHUTDOWN (INTERNET_ERROR_BASE + 12) #define ERROR_INTERNET_INCORRECT_USER_NAME (INTERNET_ERROR_BASE + 13) #define ERROR_INTERNET_INCORRECT_PASSWORD (INTERNET_ERROR_BASE + 14) #define ERROR_INTERNET_LOGIN_FAILURE (INTERNET_ERROR_BASE + 15) #define ERROR_INTERNET_INVALID_OPERATION (INTERNET_ERROR_BASE + 16) #define ERROR_INTERNET_OPERATION_CANCELLED (INTERNET_ERROR_BASE + 17) #define ERROR_INTERNET_INCORRECT_HANDLE_TYPE (INTERNET_ERROR_BASE + 18) #define ERROR_INTERNET_INCORRECT_HANDLE_STATE (INTERNET_ERROR_BASE + 19) #define ERROR_INTERNET_NOT_PROXY_REQUEST (INTERNET_ERROR_BASE + 20) #define ERROR_INTERNET_REGISTRY_VALUE_NOT_FOUND (INTERNET_ERROR_BASE + 21) #define ERROR_INTERNET_BAD_REGISTRY_PARAMETER (INTERNET_ERROR_BASE + 22) #define ERROR_INTERNET_NO_DIRECT_ACCESS (INTERNET_ERROR_BASE + 23) #define ERROR_INTERNET_NO_CONTEXT (INTERNET_ERROR_BASE + 24) #define ERROR_INTERNET_NO_CALLBACK (INTERNET_ERROR_BASE + 25) #define ERROR_INTERNET_REQUEST_PENDING (INTERNET_ERROR_BASE + 26) #define ERROR_INTERNET_INCORRECT_FORMAT (INTERNET_ERROR_BASE + 27) #define ERROR_INTERNET_ITEM_NOT_FOUND (INTERNET_ERROR_BASE + 28) #define ERROR_INTERNET_CANNOT_CONNECT (INTERNET_ERROR_BASE + 29) #define ERROR_INTERNET_CONNECTION_ABORTED (INTERNET_ERROR_BASE + 30) #define ERROR_INTERNET_CONNECTION_RESET (INTERNET_ERROR_BASE + 31) #define ERROR_INTERNET_FORCE_RETRY (INTERNET_ERROR_BASE + 32) #define ERROR_INTERNET_INVALID_PROXY_REQUEST (INTERNET_ERROR_BASE + 33) #define ERROR_INTERNET_NEED_UI (INTERNET_ERROR_BASE + 34) #define ERROR_INTERNET_HANDLE_EXISTS (INTERNET_ERROR_BASE + 36) #define ERROR_INTERNET_SEC_CERT_DATE_INVALID (INTERNET_ERROR_BASE + 37) #define ERROR_INTERNET_SEC_CERT_CN_INVALID (INTERNET_ERROR_BASE + 38) #define ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR (INTERNET_ERROR_BASE + 39) #define ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR (INTERNET_ERROR_BASE + 40) #define ERROR_INTERNET_MIXED_SECURITY (INTERNET_ERROR_BASE + 41) #define ERROR_INTERNET_CHG_POST_IS_NON_SECURE (INTERNET_ERROR_BASE + 42) #define ERROR_INTERNET_POST_IS_NON_SECURE (INTERNET_ERROR_BASE + 43) #define ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED (INTERNET_ERROR_BASE + 44) #define ERROR_INTERNET_INVALID_CA (INTERNET_ERROR_BASE + 45) #define ERROR_INTERNET_CLIENT_AUTH_NOT_SETUP (INTERNET_ERROR_BASE + 46) #define ERROR_INTERNET_ASYNC_THREAD_FAILED (INTERNET_ERROR_BASE + 47) #define ERROR_INTERNET_REDIRECT_SCHEME_CHANGE (INTERNET_ERROR_BASE + 48) #define ERROR_INTERNET_DIALOG_PENDING (INTERNET_ERROR_BASE + 49) #define ERROR_INTERNET_RETRY_DIALOG (INTERNET_ERROR_BASE + 50) #define ERROR_INTERNET_HTTPS_HTTP_SUBMIT_REDIR (INTERNET_ERROR_BASE + 52) #define ERROR_INTERNET_INSERT_CDROM (INTERNET_ERROR_BASE + 53) #define ERROR_INTERNET_FORTEZZA_LOGIN_NEEDED (INTERNET_ERROR_BASE + 54) #define ERROR_INTERNET_SEC_CERT_ERRORS (INTERNET_ERROR_BASE + 55) #define ERROR_INTERNET_SEC_CERT_NO_REV (INTERNET_ERROR_BASE + 56) #define ERROR_INTERNET_SEC_CERT_REV_FAILED (INTERNET_ERROR_BASE + 57) // // FTP API errors // #define ERROR_FTP_TRANSFER_IN_PROGRESS (INTERNET_ERROR_BASE + 110) #define ERROR_FTP_DROPPED (INTERNET_ERROR_BASE + 111) #define ERROR_FTP_NO_PASSIVE_MODE (INTERNET_ERROR_BASE + 112) // // gopher API errors // #define ERROR_GOPHER_PROTOCOL_ERROR (INTERNET_ERROR_BASE + 130) #define ERROR_GOPHER_NOT_FILE (INTERNET_ERROR_BASE + 131) #define ERROR_GOPHER_DATA_ERROR (INTERNET_ERROR_BASE + 132) #define ERROR_GOPHER_END_OF_DATA (INTERNET_ERROR_BASE + 133) #define ERROR_GOPHER_INVALID_LOCATOR (INTERNET_ERROR_BASE + 134) #define ERROR_GOPHER_INCORRECT_LOCATOR_TYPE (INTERNET_ERROR_BASE + 135) #define ERROR_GOPHER_NOT_GOPHER_PLUS (INTERNET_ERROR_BASE + 136) #define ERROR_GOPHER_ATTRIBUTE_NOT_FOUND (INTERNET_ERROR_BASE + 137) #define ERROR_GOPHER_UNKNOWN_LOCATOR (INTERNET_ERROR_BASE + 138) // // HTTP API errors // #define ERROR_HTTP_HEADER_NOT_FOUND (INTERNET_ERROR_BASE + 150) #define ERROR_HTTP_DOWNLEVEL_SERVER (INTERNET_ERROR_BASE + 151) #define ERROR_HTTP_INVALID_SERVER_RESPONSE (INTERNET_ERROR_BASE + 152) #define ERROR_HTTP_INVALID_HEADER (INTERNET_ERROR_BASE + 153) #define ERROR_HTTP_INVALID_QUERY_REQUEST (INTERNET_ERROR_BASE + 154) #define ERROR_HTTP_HEADER_ALREADY_EXISTS (INTERNET_ERROR_BASE + 155) #define ERROR_HTTP_REDIRECT_FAILED (INTERNET_ERROR_BASE + 156) #define ERROR_HTTP_NOT_REDIRECTED (INTERNET_ERROR_BASE + 160) #define ERROR_HTTP_COOKIE_NEEDS_CONFIRMATION (INTERNET_ERROR_BASE + 161) #define ERROR_HTTP_COOKIE_DECLINED (INTERNET_ERROR_BASE + 162) #define ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION (INTERNET_ERROR_BASE + 168) // // additional Internet API error codes // #define ERROR_INTERNET_SECURITY_CHANNEL_ERROR (INTERNET_ERROR_BASE + 157) #define ERROR_INTERNET_UNABLE_TO_CACHE_FILE (INTERNET_ERROR_BASE + 158) #define ERROR_INTERNET_TCPIP_NOT_INSTALLED (INTERNET_ERROR_BASE + 159) #define ERROR_INTERNET_DISCONNECTED (INTERNET_ERROR_BASE + 163) #define ERROR_INTERNET_SERVER_UNREACHABLE (INTERNET_ERROR_BASE + 164) #define ERROR_INTERNET_PROXY_SERVER_UNREACHABLE (INTERNET_ERROR_BASE + 165) #define ERROR_INTERNET_BAD_AUTO_PROXY_SCRIPT (INTERNET_ERROR_BASE + 166) #define ERROR_INTERNET_UNABLE_TO_DOWNLOAD_SCRIPT (INTERNET_ERROR_BASE + 167) #define ERROR_INTERNET_SEC_INVALID_CERT (INTERNET_ERROR_BASE + 169) #define ERROR_INTERNET_SEC_CERT_REVOKED (INTERNET_ERROR_BASE + 170) // InternetAutodial specific errors #define ERROR_INTERNET_FAILED_DUETOSECURITYCHECK (INTERNET_ERROR_BASE + 171) #define ERROR_INTERNET_NOT_INITIALIZED (INTERNET_ERROR_BASE + 172) #define ERROR_INTERNET_NEED_MSN_SSPI_PKG (INTERNET_ERROR_BASE + 173) #define ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY (INTERNET_ERROR_BASE + 174) // Decoding/Decompression specific errors #define ERROR_INTERNET_DECODING_FAILED (INTERNET_ERROR_BASE + 175) #define INTERNET_ERROR_LAST ERROR_INTERNET_DECODING_FAILED //#endif // !defined(_WINERROR_) // // URLCACHE APIs // // // datatype definitions. // // // cache entry type flags. // #define NORMAL_CACHE_ENTRY 0x00000001 #define STICKY_CACHE_ENTRY 0x00000004 #define EDITED_CACHE_ENTRY 0x00000008 #define TRACK_OFFLINE_CACHE_ENTRY 0x00000010 #define TRACK_ONLINE_CACHE_ENTRY 0x00000020 #define SPARSE_CACHE_ENTRY 0x00010000 #define COOKIE_CACHE_ENTRY 0x00100000 #define URLHISTORY_CACHE_ENTRY 0x00200000 #define URLCACHE_FIND_DEFAULT_FILTER NORMAL_CACHE_ENTRY \ | COOKIE_CACHE_ENTRY \ | URLHISTORY_CACHE_ENTRY \ | TRACK_OFFLINE_CACHE_ENTRY \ | TRACK_ONLINE_CACHE_ENTRY \ | STICKY_CACHE_ENTRY // // INTERNET_CACHE_ENTRY_INFO - // #if _MSC_VER >= 1200 #pragma warning(push) #endif #pragma warning(disable:4201) typedef struct _INTERNET_CACHE_ENTRY_INFOA { DWORD dwStructSize; // version of cache system. LPSTR lpszSourceUrlName; // embedded pointer to the URL name string. LPSTR lpszLocalFileName; // embedded pointer to the local file name. DWORD CacheEntryType; // cache type bit mask. DWORD dwUseCount; // current users count of the cache entry. DWORD dwHitRate; // num of times the cache entry was retrieved. DWORD dwSizeLow; // low DWORD of the file size. DWORD dwSizeHigh; // high DWORD of the file size. FILETIME LastModifiedTime; // last modified time of the file in GMT format. FILETIME ExpireTime; // expire time of the file in GMT format FILETIME LastAccessTime; // last accessed time in GMT format FILETIME LastSyncTime; // last time the URL was synchronized // with the source LPSTR lpHeaderInfo; // embedded pointer to the header info. DWORD dwHeaderInfoSize; // size of the above header. LPSTR lpszFileExtension; // File extension used to retrive the urldata as a file. union { // Exemption delta from last access time. DWORD dwReserved; DWORD dwExemptDelta; }; // Exemption delta from last access } INTERNET_CACHE_ENTRY_INFOA, * LPINTERNET_CACHE_ENTRY_INFOA; typedef struct _INTERNET_CACHE_ENTRY_INFOW { DWORD dwStructSize; // version of cache system. LPWSTR lpszSourceUrlName; // embedded pointer to the URL name string. LPWSTR lpszLocalFileName; // embedded pointer to the local file name. DWORD CacheEntryType; // cache type bit mask. DWORD dwUseCount; // current users count of the cache entry. DWORD dwHitRate; // num of times the cache entry was retrieved. DWORD dwSizeLow; // low DWORD of the file size. DWORD dwSizeHigh; // high DWORD of the file size. FILETIME LastModifiedTime; // last modified time of the file in GMT format. FILETIME ExpireTime; // expire time of the file in GMT format FILETIME LastAccessTime; // last accessed time in GMT format FILETIME LastSyncTime; // last time the URL was synchronized // with the source LPWSTR lpHeaderInfo; // embedded pointer to the header info. DWORD dwHeaderInfoSize; // size of the above header. LPWSTR lpszFileExtension; // File extension used to retrive the urldata as a file. union { // Exemption delta from last access time. DWORD dwReserved; DWORD dwExemptDelta; }; // Exemption delta from last access } INTERNET_CACHE_ENTRY_INFOW, * LPINTERNET_CACHE_ENTRY_INFOW; #ifdef UNICODE typedef INTERNET_CACHE_ENTRY_INFOW INTERNET_CACHE_ENTRY_INFO; typedef LPINTERNET_CACHE_ENTRY_INFOW LPINTERNET_CACHE_ENTRY_INFO; #else typedef INTERNET_CACHE_ENTRY_INFOA INTERNET_CACHE_ENTRY_INFO; typedef LPINTERNET_CACHE_ENTRY_INFOA LPINTERNET_CACHE_ENTRY_INFO; #endif // UNICODE #if _MSC_VER >= 1200 #pragma warning(pop) #else #pragma warning(default:4201) #endif typedef struct _INTERNET_CACHE_TIMESTAMPS { FILETIME ftExpires; FILETIME ftLastModified; } INTERNET_CACHE_TIMESTAMPS, *LPINTERNET_CACHE_TIMESTAMPS; // // Cache Group // typedef LONGLONG GROUPID; // // Cache Group Flags // #define CACHEGROUP_ATTRIBUTE_GET_ALL 0xffffffff #define CACHEGROUP_ATTRIBUTE_BASIC 0x00000001 #define CACHEGROUP_ATTRIBUTE_FLAG 0x00000002 #define CACHEGROUP_ATTRIBUTE_TYPE 0x00000004 #define CACHEGROUP_ATTRIBUTE_QUOTA 0x00000008 #define CACHEGROUP_ATTRIBUTE_GROUPNAME 0x00000010 #define CACHEGROUP_ATTRIBUTE_STORAGE 0x00000020 #define CACHEGROUP_FLAG_NONPURGEABLE 0x00000001 #define CACHEGROUP_FLAG_GIDONLY 0x00000004 #define CACHEGROUP_FLAG_FLUSHURL_ONDELETE 0x00000002 #define CACHEGROUP_SEARCH_ALL 0x00000000 #define CACHEGROUP_SEARCH_BYURL 0x00000001 #define CACHEGROUP_TYPE_INVALID 0x00000001 // // updatable cache group fields // #define CACHEGROUP_READWRITE_MASK \ CACHEGROUP_ATTRIBUTE_TYPE \ | CACHEGROUP_ATTRIBUTE_QUOTA \ | CACHEGROUP_ATTRIBUTE_GROUPNAME \ | CACHEGROUP_ATTRIBUTE_STORAGE // // INTERNET_CACHE_GROUP_INFO // #define GROUPNAME_MAX_LENGTH 120 #define GROUP_OWNER_STORAGE_SIZE 4 typedef struct _INTERNET_CACHE_GROUP_INFOA { DWORD dwGroupSize; DWORD dwGroupFlags; DWORD dwGroupType; DWORD dwDiskUsage; // in KB DWORD dwDiskQuota; // in KB DWORD dwOwnerStorage[GROUP_OWNER_STORAGE_SIZE]; CHAR szGroupName[GROUPNAME_MAX_LENGTH]; } INTERNET_CACHE_GROUP_INFOA, * LPINTERNET_CACHE_GROUP_INFOA; typedef struct _INTERNET_CACHE_GROUP_INFOW { DWORD dwGroupSize; DWORD dwGroupFlags; DWORD dwGroupType; DWORD dwDiskUsage; // in KB DWORD dwDiskQuota; // in KB DWORD dwOwnerStorage[GROUP_OWNER_STORAGE_SIZE]; WCHAR szGroupName[GROUPNAME_MAX_LENGTH]; } INTERNET_CACHE_GROUP_INFOW, * LPINTERNET_CACHE_GROUP_INFOW; #ifdef UNICODE typedef INTERNET_CACHE_GROUP_INFOW INTERNET_CACHE_GROUP_INFO; typedef LPINTERNET_CACHE_GROUP_INFOW LPINTERNET_CACHE_GROUP_INFO; #else typedef INTERNET_CACHE_GROUP_INFOA INTERNET_CACHE_GROUP_INFO; typedef LPINTERNET_CACHE_GROUP_INFOA LPINTERNET_CACHE_GROUP_INFO; #endif // UNICODE // // Cache APIs // BOOLAPI CreateUrlCacheEntryA( __in LPCSTR lpszUrlName, __in DWORD dwExpectedFileSize, __in_opt LPCSTR lpszFileExtension, __inout_ecount(MAX_PATH) LPSTR lpszFileName, __in DWORD dwReserved ); BOOLAPI CreateUrlCacheEntryW( __in LPCWSTR lpszUrlName, __in DWORD dwExpectedFileSize, __in_opt LPCWSTR lpszFileExtension, __inout_ecount(MAX_PATH) LPWSTR lpszFileName, __in DWORD dwReserved ); #ifdef UNICODE #define CreateUrlCacheEntry CreateUrlCacheEntryW #else #define CreateUrlCacheEntry CreateUrlCacheEntryA #endif // !UNICODE #ifndef USE_FIXED_COMMIT_URL_CACHE_ENTRY // Temporary state of affairs until we reconcile our apis. // Why are we doing this? HeaderInfo _should_ be string data. // However, one group is passing binary data instead. For the // unicode api, we've decided to disallow this, but this // brings up an inconsistency between the u and a apis, which // is undesirable. // For Beta 1, we'll go with this behaviour, but in future releases // we want to make these apis consistent. BOOLAPI CommitUrlCacheEntryA( __in LPCSTR lpszUrlName, __in_opt LPCSTR lpszLocalFileName, __in FILETIME ExpireTime, __in FILETIME LastModifiedTime, __in DWORD CacheEntryType, __in_ecount_opt(dwHeaderSize) LPBYTE lpHeaderInfo, __in_opt DWORD dwHeaderSize, __reserved LPCSTR lpszFileExtension, __in_opt LPCSTR lpszOriginalUrl ); BOOLAPI CommitUrlCacheEntryW( __in LPCWSTR lpszUrlName, __in_opt LPCWSTR lpszLocalFileName, __in FILETIME ExpireTime, __in FILETIME LastModifiedTime, __in DWORD CacheEntryType, __in_ecount_opt(dwHeaders) LPWSTR lpszHeaderInfo, __in DWORD dwHeaders, __reserved LPCWSTR lpszFileExtension, __in_opt LPCWSTR lpszOriginalUrl ); #ifdef UNICODE #define CommitUrlCacheEntry CommitUrlCacheEntryW #else #define CommitUrlCacheEntry CommitUrlCacheEntryA #endif #else CommitUrlCacheEntryA( __in LPCSTR lpszUrlName, __in_opt LPCSTR lpszLocalFileName, __in FILETIME ExpireTime, __in FILETIME LastModifiedTime, __in DWORD CacheEntryType, __in_ecount_opt(dwHeaderSize) LPCSTR lpHeaderInfo, __in DWORD dwHeaderSize, __reserved LPCSTR lpszFileExtension, __in_opt LPCSTR lpszOriginalUrl ); CommitUrlCacheEntryW( __in LPCWSTR lpszUrlName, __in_opt LPCWSTR lpszLocalFileName, __in FILETIME ExpireTime, __in FILETIME LastModifiedTime, __in DWORD CacheEntryType, __in_ecount_opt(dwHeaderSize) LPCWSTR lpHeaderInfo, __in DWORD dwHeaderSize, __reserved LPCWSTR lpszFileExtension, __in_opt LPCWSTR lpszOriginalUrl ); #ifdef UNICODE #define CommitUrlCacheEntry CommitUrlCacheEntryW #else #define CommitUrlCacheEntry CommitUrlCacheEntryA #endif // !UNICODE #endif BOOLAPI RetrieveUrlCacheEntryFileA( __in LPCSTR lpszUrlName, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo, __reserved DWORD dwReserved ); BOOLAPI RetrieveUrlCacheEntryFileW( __in LPCWSTR lpszUrlName, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo, __reserved DWORD dwReserved ); #ifdef UNICODE #define RetrieveUrlCacheEntryFile RetrieveUrlCacheEntryFileW #else #define RetrieveUrlCacheEntryFile RetrieveUrlCacheEntryFileA #endif // !UNICODE BOOLAPI UnlockUrlCacheEntryFileA( __in LPCSTR lpszUrlName, __reserved DWORD dwReserved ); BOOLAPI UnlockUrlCacheEntryFileW( __in LPCWSTR lpszUrlName, __reserved DWORD dwReserved ); #ifdef UNICODE #define UnlockUrlCacheEntryFile UnlockUrlCacheEntryFileW #else #ifdef _WINX32_ #define UnlockUrlCacheEntryFile UnlockUrlCacheEntryFileA #else BOOLAPI UnlockUrlCacheEntryFile( __in LPCSTR lpszUrlName, __reserved DWORD dwReserved ); #endif // _WINX32_ #endif // !UNICODE INTERNETAPI_(HANDLE) RetrieveUrlCacheEntryStreamA( __in LPCSTR lpszUrlName, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo, __in BOOL fRandomRead, __reserved DWORD dwReserved ); INTERNETAPI_(HANDLE) RetrieveUrlCacheEntryStreamW( __in LPCWSTR lpszUrlName, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo, __in BOOL fRandomRead, __reserved DWORD dwReserved ); #ifdef UNICODE #define RetrieveUrlCacheEntryStream RetrieveUrlCacheEntryStreamW #else #define RetrieveUrlCacheEntryStream RetrieveUrlCacheEntryStreamA #endif // !UNICODE BOOLAPI ReadUrlCacheEntryStream( __in HANDLE hUrlCacheStream, __in DWORD dwLocation, __out_bcount(*lpdwLen) __out_data_source(NETWORK) LPVOID lpBuffer, __inout LPDWORD lpdwLen, __reserved DWORD Reserved ); BOOLAPI ReadUrlCacheEntryStreamEx( __in HANDLE hUrlCacheStream, __in DWORDLONG qwLocation, __out_bcount(*lpdwLen) __out_data_source(NETWORK) LPVOID lpBuffer, __inout LPDWORD lpdwLen ); BOOLAPI UnlockUrlCacheEntryStream( __in HANDLE hUrlCacheStream, __reserved DWORD Reserved ); URLCACHEAPI_(BOOL) GetUrlCacheEntryInfoA( __in LPCSTR lpszUrlName, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo, __inout_opt LPDWORD lpcbCacheEntryInfo ); URLCACHEAPI_(BOOL) GetUrlCacheEntryInfoW( __in LPCWSTR lpszUrlName, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo, __inout_opt LPDWORD lpcbCacheEntryInfo ); #ifdef UNICODE #define GetUrlCacheEntryInfo GetUrlCacheEntryInfoW #else #define GetUrlCacheEntryInfo GetUrlCacheEntryInfoA #endif // !UNICODE URLCACHEAPI_(HANDLE) FindFirstUrlCacheGroup( __in DWORD dwFlags, __in DWORD dwFilter, __reserved LPVOID lpSearchCondition, __reserved DWORD dwSearchCondition, __out GROUPID* lpGroupId, __reserved LPVOID lpReserved ); URLCACHEAPI_(BOOL) FindNextUrlCacheGroup( __in HANDLE hFind, __out GROUPID* lpGroupId, __reserved LPVOID lpReserved ); URLCACHEAPI_(BOOL) GetUrlCacheGroupAttributeA( __in GROUPID gid, __reserved DWORD dwFlags, __in DWORD dwAttributes, __out LPINTERNET_CACHE_GROUP_INFOA lpGroupInfo, __inout LPDWORD lpdwGroupInfo, __reserved LPVOID lpReserved ); URLCACHEAPI_(BOOL) GetUrlCacheGroupAttributeW( __in GROUPID gid, __reserved DWORD dwFlags, __in DWORD dwAttributes, __out LPINTERNET_CACHE_GROUP_INFOW lpGroupInfo, __inout LPDWORD lpdwGroupInfo, __reserved LPVOID lpReserved ); #ifdef UNICODE #define GetUrlCacheGroupAttribute GetUrlCacheGroupAttributeW #else #define GetUrlCacheGroupAttribute GetUrlCacheGroupAttributeA #endif // !UNICODE URLCACHEAPI_(BOOL) SetUrlCacheGroupAttributeA( __in GROUPID gid, __reserved DWORD dwFlags, __in DWORD dwAttributes, __in LPINTERNET_CACHE_GROUP_INFOA lpGroupInfo, __reserved LPVOID lpReserved ); URLCACHEAPI_(BOOL) SetUrlCacheGroupAttributeW( __in GROUPID gid, __reserved DWORD dwFlags, __in DWORD dwAttributes, __in LPINTERNET_CACHE_GROUP_INFOW lpGroupInfo, __reserved LPVOID lpReserved ); #ifdef UNICODE #define SetUrlCacheGroupAttribute SetUrlCacheGroupAttributeW #else #define SetUrlCacheGroupAttribute SetUrlCacheGroupAttributeA #endif // !UNICODE BOOLAPI GetUrlCacheEntryInfoExA( __in LPCSTR lpszUrl, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo, __inout_opt LPDWORD lpcbCacheEntryInfo, __reserved LPSTR lpszRedirectUrl, __reserved LPDWORD lpcbRedirectUrl, __reserved LPVOID lpReserved, __in DWORD dwFlags ); BOOLAPI GetUrlCacheEntryInfoExW( __in LPCWSTR lpszUrl, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo, __inout_opt LPDWORD lpcbCacheEntryInfo, __reserved LPWSTR lpszRedirectUrl, __reserved LPDWORD lpcbRedirectUrl, __reserved LPVOID lpReserved, __in DWORD dwFlags ); #ifdef UNICODE #define GetUrlCacheEntryInfoEx GetUrlCacheEntryInfoExW #else #define GetUrlCacheEntryInfoEx GetUrlCacheEntryInfoExA #endif // !UNICODE #define CACHE_ENTRY_ATTRIBUTE_FC 0x00000004 #define CACHE_ENTRY_HITRATE_FC 0x00000010 #define CACHE_ENTRY_MODTIME_FC 0x00000040 #define CACHE_ENTRY_EXPTIME_FC 0x00000080 #define CACHE_ENTRY_ACCTIME_FC 0x00000100 #define CACHE_ENTRY_SYNCTIME_FC 0x00000200 #define CACHE_ENTRY_HEADERINFO_FC 0x00000400 #define CACHE_ENTRY_EXEMPT_DELTA_FC 0x00000800 BOOLAPI SetUrlCacheEntryInfoA( __in LPCSTR lpszUrlName, __in LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo, __in DWORD dwFieldControl ); BOOLAPI SetUrlCacheEntryInfoW( __in LPCWSTR lpszUrlName, __in LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo, __in DWORD dwFieldControl ); #ifdef UNICODE #define SetUrlCacheEntryInfo SetUrlCacheEntryInfoW #else #define SetUrlCacheEntryInfo SetUrlCacheEntryInfoA #endif // !UNICODE // // Cache Group Functions // INTERNETAPI_(GROUPID) CreateUrlCacheGroup( __in DWORD dwFlags, __reserved LPVOID lpReserved ); BOOLAPI DeleteUrlCacheGroup( __in GROUPID GroupId, __in DWORD dwFlags, // must pass 0 __reserved LPVOID lpReserved ); // Flags for SetUrlCacheEntryGroup #define INTERNET_CACHE_GROUP_ADD 0 #define INTERNET_CACHE_GROUP_REMOVE 1 BOOLAPI SetUrlCacheEntryGroupA( __in LPCSTR lpszUrlName, __in DWORD dwFlags, __in GROUPID GroupId, __reserved LPBYTE pbGroupAttributes, __reserved DWORD cbGroupAttributes, __reserved LPVOID lpReserved ); BOOLAPI SetUrlCacheEntryGroupW( __in LPCWSTR lpszUrlName, __in DWORD dwFlags, __in GROUPID GroupId, __reserved LPBYTE pbGroupAttributes, __reserved DWORD cbGroupAttributes, __reserved LPVOID lpReserved ); #ifdef UNICODE #define SetUrlCacheEntryGroup SetUrlCacheEntryGroupW #else #ifdef _WINX32_ #define SetUrlCacheEntryGroup SetUrlCacheEntryGroupA #else BOOLAPI SetUrlCacheEntryGroup( __in LPCSTR lpszUrlName, __in DWORD dwFlags, __in GROUPID GroupId, __reserved LPBYTE pbGroupAttributes, __reserved DWORD cbGroupAttributes, __reserved LPVOID lpReserved ); #endif // _WINX32_ #endif // !UNICODE INTERNETAPI_(HANDLE) FindFirstUrlCacheEntryExA( __in_opt LPCSTR lpszUrlSearchPattern, __in DWORD dwFlags, __in DWORD dwFilter, __in GROUPID GroupId, __inout_bcount_opt(*lpcbEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo, __inout LPDWORD lpcbEntryInfo, __reserved LPVOID lpGroupAttributes, __reserved LPDWORD lpcbGroupAttributes, __reserved LPVOID lpReserved ); INTERNETAPI_(HANDLE) FindFirstUrlCacheEntryExW( __in_opt LPCWSTR lpszUrlSearchPattern, __in DWORD dwFlags, __in DWORD dwFilter, __in GROUPID GroupId, __inout_bcount_opt(*lpcbEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo, __inout LPDWORD lpcbEntryInfo, __reserved LPVOID lpGroupAttributes, __reserved LPDWORD lpcbGroupAttributes, __reserved LPVOID lpReserved ); #ifdef UNICODE #define FindFirstUrlCacheEntryEx FindFirstUrlCacheEntryExW #else #define FindFirstUrlCacheEntryEx FindFirstUrlCacheEntryExA #endif // !UNICODE BOOLAPI FindNextUrlCacheEntryExA( __in HANDLE hEnumHandle, __inout_bcount_opt(*lpcbEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpNextCacheEntryInfo, __inout LPDWORD lpcbEntryInfo, __reserved LPVOID lpGroupAttributes, __reserved LPDWORD lpcbGroupAttributes, __reserved LPVOID lpReserved ); BOOLAPI FindNextUrlCacheEntryExW( __in HANDLE hEnumHandle, __inout_bcount_opt(*lpcbEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpNextCacheEntryInfo, __inout LPDWORD lpcbEntryInfo, __reserved LPVOID lpGroupAttributes, __reserved LPDWORD lpcbGroupAttributes, __reserved LPVOID lpReserved ); #ifdef UNICODE #define FindNextUrlCacheEntryEx FindNextUrlCacheEntryExW #else #define FindNextUrlCacheEntryEx FindNextUrlCacheEntryExA #endif // !UNICODE INTERNETAPI_(HANDLE) FindFirstUrlCacheEntryA( __in_opt LPCSTR lpszUrlSearchPattern, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo ); INTERNETAPI_(HANDLE) FindFirstUrlCacheEntryW( __in_opt LPCWSTR lpszUrlSearchPattern, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo ); #ifdef UNICODE #define FindFirstUrlCacheEntry FindFirstUrlCacheEntryW #else #define FindFirstUrlCacheEntry FindFirstUrlCacheEntryA #endif // !UNICODE BOOLAPI FindNextUrlCacheEntryA( __in HANDLE hEnumHandle, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOA lpNextCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo ); BOOLAPI FindNextUrlCacheEntryW( __in HANDLE hEnumHandle, __inout_bcount_opt(*lpcbCacheEntryInfo) LPINTERNET_CACHE_ENTRY_INFOW lpNextCacheEntryInfo, __inout LPDWORD lpcbCacheEntryInfo ); #ifdef UNICODE #define FindNextUrlCacheEntry FindNextUrlCacheEntryW #else #define FindNextUrlCacheEntry FindNextUrlCacheEntryA #endif // !UNICODE BOOLAPI FindCloseUrlCache( __in HANDLE hEnumHandle ); BOOLAPI DeleteUrlCacheEntryA( __in LPCSTR lpszUrlName ); BOOLAPI DeleteUrlCacheEntryW( __in LPCWSTR lpszUrlName ); #ifdef UNICODE #define DeleteUrlCacheEntry DeleteUrlCacheEntryW #else #ifdef _WINX32_ #define DeleteUrlCacheEntry DeleteUrlCacheEntryA #else BOOLAPI DeleteUrlCacheEntry( __in LPCSTR lpszUrlName ); #endif // _WINX32_ #endif // !UNICODE // // Autodial APIs // INTERNETAPI_(DWORD) InternetDialA( __in HWND hwndParent, __in_opt LPSTR lpszConnectoid, __in DWORD dwFlags, __out DWORD_PTR *lpdwConnection, __in DWORD dwReserved ); INTERNETAPI_(DWORD) InternetDialW( __in HWND hwndParent, __in_opt LPWSTR lpszConnectoid, __in DWORD dwFlags, __out DWORD_PTR *lpdwConnection, __in DWORD dwReserved ); #ifdef UNICODE #define InternetDial InternetDialW #else #ifdef _WINX32_ #define InternetDial InternetDialA #else INTERNETAPI_(DWORD) InternetDial( __in HWND hwndParent, __in_opt LPSTR lpszConnectoid, __in DWORD dwFlags, __out LPDWORD lpdwConnection, __in DWORD dwReserved ); #endif // _WINX32_ #endif // !UNICODE // Flags for InternetDial - must not conflict with InternetAutodial flags // as they are valid here also. #define INTERNET_DIAL_FORCE_PROMPT 0x2000 #define INTERNET_DIAL_SHOW_OFFLINE 0x4000 #define INTERNET_DIAL_UNATTENDED 0x8000 INTERNETAPI_(DWORD) InternetHangUp( __in DWORD_PTR dwConnection, __reserved DWORD dwReserved); #define INTERENT_GOONLINE_REFRESH 0x00000001 #define INTERENT_GOONLINE_MASK 0x00000001 INTERNETAPI_(BOOL) InternetGoOnlineA( __in_opt LPCSTR lpszURL, __in HWND hwndParent, __in DWORD dwFlags ); INTERNETAPI_(BOOL) InternetGoOnlineW( __in_opt LPCWSTR lpszURL, __in HWND hwndParent, __in DWORD dwFlags ); #ifdef UNICODE #define InternetGoOnline InternetGoOnlineW #else #ifdef _WINX32_ #define InternetGoOnline InternetGoOnlineA #else INTERNETAPI_(BOOL) InternetGoOnline( __in_opt LPSTR lpszURL, __in HWND hwndParent, __in DWORD dwFlags ); #endif // _WINX32_ #endif // !UNICODE INTERNETAPI_(BOOL) InternetAutodial( __in DWORD dwFlags, __in_opt HWND hwndParent); // Flags for InternetAutodial #define INTERNET_AUTODIAL_FORCE_ONLINE 1 #define INTERNET_AUTODIAL_FORCE_UNATTENDED 2 #define INTERNET_AUTODIAL_FAILIFSECURITYCHECK 4 #define INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT 8 #define INTERNET_AUTODIAL_FLAGS_MASK (INTERNET_AUTODIAL_FORCE_ONLINE | INTERNET_AUTODIAL_FORCE_UNATTENDED | INTERNET_AUTODIAL_FAILIFSECURITYCHECK | INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT) INTERNETAPI_(BOOL) InternetAutodialHangup( __in DWORD dwReserved); INTERNETAPI_(BOOL) InternetGetConnectedState( __out LPDWORD lpdwFlags, __reserved DWORD dwReserved); INTERNETAPI_(BOOL) InternetGetConnectedStateExA( __out_opt LPDWORD lpdwFlags, __out_ecount_opt(dwBufLen) LPSTR lpszConnectionName, __in DWORD dwBufLen, __reserved DWORD dwReserved ); INTERNETAPI_(BOOL) InternetGetConnectedStateExW( __out_opt LPDWORD lpdwFlags, __out_ecount_opt(dwBufLen) LPWSTR lpszConnectionName, __in DWORD dwBufLen, __reserved DWORD dwReserved ); #define PROXY_AUTO_DETECT_TYPE_DHCP 1 #define PROXY_AUTO_DETECT_TYPE_DNS_A 2 struct AutoProxyHelperFunctions; typedef struct AutoProxyHelperVtbl { BOOL ( __stdcall *IsResolvable )( LPSTR lpszHost); DWORD ( __stdcall *GetIPAddress )( LPSTR lpszIPAddress, LPDWORD lpdwIPAddressSize); DWORD ( __stdcall *ResolveHostName )( LPSTR lpszHostName, LPSTR lpszIPAddress, LPDWORD lpdwIPAddressSize); BOOL ( __stdcall *IsInNet )( LPSTR lpszIPAddress, LPSTR lpszDest, LPSTR lpszMask); BOOL ( __stdcall *IsResolvableEx )( LPSTR lpszHost ); DWORD ( __stdcall *GetIPAddressEx )( LPSTR lpszIPAddress, LPDWORD lpdwIPAddressSize ); DWORD ( __stdcall *ResolveHostNameEx )( LPSTR lpszHostName, LPSTR lpszIPAddress, LPDWORD lpdwIPAddressSize ); BOOL ( __stdcall *IsInNetEx )( LPSTR lpszIPAddress, LPSTR lpszIPPrefix ); DWORD ( __stdcall *SortIpList )( LPSTR lpszIPAddressList, LPSTR lpszIPSortedList, LPDWORD lpdwIPSortedListSize ); }AutoProxyHelperVtbl; typedef struct { DWORD dwStructSize; // Size of struct LPSTR lpszScriptBuffer; // Buffer to Pass DWORD dwScriptBufferSize; // Size of buffer above } AUTO_PROXY_SCRIPT_BUFFER, *LPAUTO_PROXY_SCRIPT_BUFFER; typedef struct AutoProxyHelperFunctions { const struct AutoProxyHelperVtbl * lpVtbl; } AutoProxyHelperFunctions; typedef BOOL ( CALLBACK *pfnInternetInitializeAutoProxyDll)(DWORD dwVersion, LPSTR lpszDownloadedTempFile, LPSTR lpszMime, AutoProxyHelperFunctions* lpAutoProxyCallbacks, LPAUTO_PROXY_SCRIPT_BUFFER lpAutoProxyScriptBuffer ); typedef BOOL (CALLBACK *pfnInternetDeInitializeAutoProxyDll)(LPSTR lpszMime, DWORD dwReserved); typedef BOOL (CALLBACK *pfnInternetGetProxyInfo)(LPCSTR lpszUrl, DWORD dwUrlLength, LPSTR lpszUrlHostName, DWORD dwUrlHostNameLength, LPSTR* lplpszProxyHostName, LPDWORD lpdwProxyHostNameLength); typedef enum{ WPAD_CACHE_DELETE_CURRENT = 0x0, WPAD_CACHE_DELETE_ALL = 0x1 } WPAD_CACHE_DELETE; INTERNETAPI_(BOOL) DeleteWpadCacheForNetworks( __in WPAD_CACHE_DELETE ); INTERNETAPI_(BOOL) InternetInitializeAutoProxyDll( __in DWORD dwReserved ); INTERNETAPI_(BOOL) DetectAutoProxyUrl( __out_ecount(dwAutoProxyUrlLength) LPSTR lpszAutoProxyUrl, __in DWORD dwAutoProxyUrlLength, __in DWORD dwDetectFlags ); INTERNETAPI_(BOOL) CreateMD5SSOHash ( __in PWSTR pszChallengeInfo, __in PWSTR pwszRealm, __in PWSTR pwszTarget, __out PBYTE pbHexHash ); #ifdef UNICODE #define InternetGetConnectedStateEx InternetGetConnectedStateExW #else #ifdef _WINX32_ #define InternetGetConnectedStateEx InternetGetConnectedStateExA #else INTERNETAPI_(BOOL) InternetGetConnectedStateEx( __out LPDWORD lpdwFlags, __out_ecount_opt(dwNameLen) LPSTR lpszConnectionName, __in DWORD dwNameLen, __in DWORD dwReserved ); #endif // _WINX32_ #endif // !UNICODE // Flags for InternetGetConnectedState and Ex #define INTERNET_CONNECTION_MODEM 0x01 #define INTERNET_CONNECTION_LAN 0x02 #define INTERNET_CONNECTION_PROXY 0x04 #define INTERNET_CONNECTION_MODEM_BUSY 0x08 /* no longer used */ #define INTERNET_RAS_INSTALLED 0x10 #define INTERNET_CONNECTION_OFFLINE 0x20 #define INTERNET_CONNECTION_CONFIGURED 0x40 // // Custom dial handler functions // // Custom dial handler prototype typedef DWORD (CALLBACK * PFN_DIAL_HANDLER) (HWND, LPCSTR, DWORD, LPDWORD); // Flags for custom dial handler #define INTERNET_CUSTOMDIAL_CONNECT 0 #define INTERNET_CUSTOMDIAL_UNATTENDED 1 #define INTERNET_CUSTOMDIAL_DISCONNECT 2 #define INTERNET_CUSTOMDIAL_SHOWOFFLINE 4 // Custom dial handler supported functionality flags #define INTERNET_CUSTOMDIAL_SAFE_FOR_UNATTENDED 1 #define INTERNET_CUSTOMDIAL_WILL_SUPPLY_STATE 2 #define INTERNET_CUSTOMDIAL_CAN_HANGUP 4 INTERNETAPI_(BOOL) InternetSetDialStateA( __in_opt LPCSTR lpszConnectoid, __in DWORD dwState, __in DWORD dwReserved ); INTERNETAPI_(BOOL) InternetSetDialStateW( __in_opt LPCWSTR lpszConnectoid, __in DWORD dwState, __in DWORD dwReserved ); #ifdef UNICODE #define InternetSetDialState InternetSetDialStateW #else #ifdef _WINX32_ #define InternetSetDialState InternetSetDialStateA #else INTERNETAPI_(BOOL) InternetSetDialState( __in_opt LPCSTR lpszConnectoid, __in DWORD dwState, __in DWORD dwReserved ); #endif // _WINX32_ #endif // !UNICODE // States for InternetSetDialState #define INTERNET_DIALSTATE_DISCONNECTED 1 INTERNETAPI_(BOOL) InternetSetPerSiteCookieDecisionA( __in LPCSTR pchHostName, __in DWORD dwDecision ); INTERNETAPI_(BOOL) InternetSetPerSiteCookieDecisionW( __in LPCWSTR pchHostName, __in DWORD dwDecision ); #ifdef UNICODE #define InternetSetPerSiteCookieDecision InternetSetPerSiteCookieDecisionW #else #define InternetSetPerSiteCookieDecision InternetSetPerSiteCookieDecisionA #endif // !UNICODE INTERNETAPI_(BOOL) InternetGetPerSiteCookieDecisionA( __in LPCSTR pchHostName, __out unsigned long* pResult ); INTERNETAPI_(BOOL) InternetGetPerSiteCookieDecisionW( __in LPCWSTR pchHostName, __out unsigned long* pResult ); #ifdef UNICODE #define InternetGetPerSiteCookieDecision InternetGetPerSiteCookieDecisionW #else #define InternetGetPerSiteCookieDecision InternetGetPerSiteCookieDecisionA #endif // !UNICODE INTERNETAPI_(BOOL) InternetClearAllPerSiteCookieDecisions(); INTERNETAPI_(BOOL) InternetEnumPerSiteCookieDecisionA( __out_ecount(*pcSiteNameSize) LPSTR pszSiteName, __inout unsigned long *pcSiteNameSize, __out unsigned long *pdwDecision, __in unsigned long dwIndex ); INTERNETAPI_(BOOL) InternetEnumPerSiteCookieDecisionW( __out_ecount(*pcSiteNameSize) LPWSTR pszSiteName, __inout unsigned long *pcSiteNameSize, __out unsigned long *pdwDecision, __in unsigned long dwIndex ); #ifdef UNICODE #define InternetEnumPerSiteCookieDecision InternetEnumPerSiteCookieDecisionW #else #define InternetEnumPerSiteCookieDecision InternetEnumPerSiteCookieDecisionA #endif // !UNICODE #define INTERNET_IDENTITY_FLAG_PRIVATE_CACHE 0x01 #define INTERNET_IDENTITY_FLAG_SHARED_CACHE 0x02 #define INTERNET_IDENTITY_FLAG_CLEAR_DATA 0x04 #define INTERNET_IDENTITY_FLAG_CLEAR_COOKIES 0x08 #define INTERNET_IDENTITY_FLAG_CLEAR_HISTORY 0x10 #define INTERNET_IDENTITY_FLAG_CLEAR_CONTENT 0x20 #define INTERNET_SUPPRESS_RESET_ALL 0x00 #define INTERNET_SUPPRESS_COOKIE_POLICY 0x01 #define INTERNET_SUPPRESS_COOKIE_POLICY_RESET 0x02 // // Privacy settings values and APIs // #define PRIVACY_TEMPLATE_NO_COOKIES 0 #define PRIVACY_TEMPLATE_HIGH 1 #define PRIVACY_TEMPLATE_MEDIUM_HIGH 2 #define PRIVACY_TEMPLATE_MEDIUM 3 #define PRIVACY_TEMPLATE_MEDIUM_LOW 4 #define PRIVACY_TEMPLATE_LOW 5 #define PRIVACY_TEMPLATE_CUSTOM 100 #define PRIVACY_TEMPLATE_ADVANCED 101 #define PRIVACY_TEMPLATE_MAX PRIVACY_TEMPLATE_LOW #define PRIVACY_TYPE_FIRST_PARTY 0 #define PRIVACY_TYPE_THIRD_PARTY 1 INTERNETAPI_(DWORD) PrivacySetZonePreferenceW( __in DWORD dwZone, __in DWORD dwType, __in DWORD dwTemplate, __in_opt LPCWSTR pszPreference ); INTERNETAPI_(DWORD) PrivacyGetZonePreferenceW( __in DWORD dwZone, __in DWORD dwType, __out_opt LPDWORD pdwTemplate, __out_ecount_opt(*pdwBufferLength) LPWSTR pszBuffer, __inout_opt LPDWORD pdwBufferLength ); #if defined(__cplusplus) } #endif /* * Return packing to whatever it was before we * entered this file */ #include #endif // !defined(_WININET_)