/*++ Copyright (c) Microsoft Corporation. All rights reserved. Module Name: winhttp.h Abstract: Contains manifests, macros, types and prototypes for Windows HTTP Services --*/ #if !defined(_WINHTTPX_) #define _WINHTTPX_ #include <winapifamily.h> #pragma region Application Family or OneCore Family or Games Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) /* * Set up Structure Packing to be 4 bytes for all winhttp structures */ #if defined(_WIN64) #include <pshpack8.h> #else #include <pshpack4.h> #endif #if defined(__cplusplus) extern "C" { #endif #if !defined(_WINHTTP_INTERNAL_) #define WINHTTPAPI DECLSPEC_IMPORT #else #define WINHTTPAPI #endif #define BOOLAPI WINHTTPAPI BOOL WINAPI // // types // typedef LPVOID HINTERNET; typedef HINTERNET * LPHINTERNET; typedef WORD INTERNET_PORT; typedef INTERNET_PORT * LPINTERNET_PORT; // // manifests // #define INTERNET_DEFAULT_PORT 0 // use the protocol-specific default #define INTERNET_DEFAULT_HTTP_PORT 80 // " " HTTP " #define INTERNET_DEFAULT_HTTPS_PORT 443 // " " HTTPS " // flags for WinHttpOpen(): #define WINHTTP_FLAG_ASYNC 0x10000000 // this session is asynchronous (where supported) #define WINHTTP_FLAG_SECURE_DEFAULTS 0x30000000 // note that this flag also forces async // flags for WinHttpOpenRequest(): #define WINHTTP_FLAG_SECURE 0x00800000 // use SSL if applicable (HTTPS) #define WINHTTP_FLAG_ESCAPE_PERCENT 0x00000004 // if escaping enabled, escape percent as well #define WINHTTP_FLAG_NULL_CODEPAGE 0x00000008 // assume all symbols are ASCII, use fast convertion #define WINHTTP_FLAG_BYPASS_PROXY_CACHE 0x00000100 // add "pragma: no-cache" request header #define WINHTTP_FLAG_REFRESH WINHTTP_FLAG_BYPASS_PROXY_CACHE #define WINHTTP_FLAG_ESCAPE_DISABLE 0x00000040 // disable escaping #define WINHTTP_FLAG_ESCAPE_DISABLE_QUERY 0x00000080 // if escaping enabled escape path part, but do not escape query #define SECURITY_FLAG_IGNORE_UNKNOWN_CA 0x00000100 #define SECURITY_FLAG_IGNORE_CERT_DATE_INVALID 0x00002000 // expired X509 Cert. #define SECURITY_FLAG_IGNORE_CERT_CN_INVALID 0x00001000 // bad common name in X509 Cert. #define SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE 0x00000200 #define SECURITY_FLAG_IGNORE_ALL_CERT_ERRORS (SECURITY_FLAG_IGNORE_UNKNOWN_CA | \ SECURITY_FLAG_IGNORE_CERT_DATE_INVALID | \ SECURITY_FLAG_IGNORE_CERT_CN_INVALID | \ SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE) // // WINHTTP_ASYNC_RESULT - this structure is returned to the application via // the callback with WINHTTP_CALLBACK_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 _WINHTTP_ASYNC_RESULT { DWORD_PTR dwResult; // indicates which async API has encountered an error DWORD dwError; // the error code if the API failed } WINHTTP_ASYNC_RESULT, *LPWINHTTP_ASYNC_RESULT, *PWINHTTP_ASYNC_RESULT; // // HTTP_VERSION_INFO - query or set global HTTP version (1.0 or 1.1) // typedef struct _HTTP_VERSION_INFO { DWORD dwMajorVersion; DWORD dwMinorVersion; } HTTP_VERSION_INFO, *LPHTTP_VERSION_INFO, *PHTTP_VERSION_INFO; // // INTERNET_SCHEME - URL scheme type // typedef int INTERNET_SCHEME, *LPINTERNET_SCHEME; #define INTERNET_SCHEME_HTTP (1) #define INTERNET_SCHEME_HTTPS (2) #define INTERNET_SCHEME_FTP (3) #define INTERNET_SCHEME_SOCKS (4) // // URL_COMPONENTS - the constituent parts of an URL. Used in WinHttpCrackUrl() // and WinHttpCreateUrl() // // For WinHttpCrackUrl(), 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 WinHttpCreateUrl(), 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 // #pragma warning( disable : 4121 ) // disable alignment warning typedef struct _WINHTTP_URL_COMPONENTS { 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_COMPONENTS, *LPURL_COMPONENTS; typedef URL_COMPONENTS URL_COMPONENTSW; typedef LPURL_COMPONENTS LPURL_COMPONENTSW; #pragma warning( default : 4121 ) // restore alignment warning // // WINHTTP_PROXY_INFO - structure supplied with WINHTTP_OPTION_PROXY to get/ // set proxy information on a WinHttpOpen() handle // typedef struct _WINHTTP_PROXY_INFO { DWORD dwAccessType; // see WINHTTP_ACCESS_* types below LPWSTR lpszProxy; // proxy server list LPWSTR lpszProxyBypass; // proxy bypass list } WINHTTP_PROXY_INFO, *LPWINHTTP_PROXY_INFO, *PWINHTTP_PROXY_INFO; typedef WINHTTP_PROXY_INFO WINHTTP_PROXY_INFOW; typedef LPWINHTTP_PROXY_INFO LPWINHTTP_PROXY_INFOW; #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) */ #pragma endregion #pragma region Application Family or OneCore Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) typedef struct _WINHTTP_AUTOPROXY_OPTIONS { DWORD dwFlags; DWORD dwAutoDetectFlags; LPCWSTR lpszAutoConfigUrl; LPVOID lpvReserved; DWORD dwReserved; BOOL fAutoLogonIfChallenged; } WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS; #define WINHTTP_AUTOPROXY_AUTO_DETECT 0x00000001 #define WINHTTP_AUTOPROXY_CONFIG_URL 0x00000002 #define WINHTTP_AUTOPROXY_HOST_KEEPCASE 0x00000004 #define WINHTTP_AUTOPROXY_HOST_LOWERCASE 0x00000008 #define WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG 0x00000100 #define WINHTTP_AUTOPROXY_ALLOW_STATIC 0x00000200 #define WINHTTP_AUTOPROXY_ALLOW_CM 0x00000400 #define WINHTTP_AUTOPROXY_RUN_INPROCESS 0x00010000 #define WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY 0x00020000 #define WINHTTP_AUTOPROXY_NO_DIRECTACCESS 0x00040000 #define WINHTTP_AUTOPROXY_NO_CACHE_CLIENT 0x00080000 #define WINHTTP_AUTOPROXY_NO_CACHE_SVC 0x00100000 #define WINHTTP_AUTOPROXY_SORT_RESULTS 0x00400000 // // Flags for dwAutoDetectFlags // #define WINHTTP_AUTO_DETECT_TYPE_DHCP 0x00000001 #define WINHTTP_AUTO_DETECT_TYPE_DNS_A 0x00000002 // // WINHTTP_PROXY_RESULT - structure containing parsed proxy result, // see WinHttpGetProxyForUrlEx and WinHttpGetProxyResult, use WinHttpFreeProxyResult to free its members. // typedef struct _WINHTTP_PROXY_RESULT_ENTRY { BOOL fProxy; // Is this a proxy or DIRECT? BOOL fBypass; // If DIRECT, is it bypassing a proxy (intranet) or is all traffic DIRECT (internet) INTERNET_SCHEME ProxyScheme; // The scheme of the proxy, SOCKS, HTTP (CERN Proxy), HTTPS (SSL through Proxy) PWSTR pwszProxy; // Hostname of the proxy. INTERNET_PORT ProxyPort; // Port of the proxy. } WINHTTP_PROXY_RESULT_ENTRY; typedef struct _WINHTTP_PROXY_RESULT { DWORD cEntries; WINHTTP_PROXY_RESULT_ENTRY *pEntries; } WINHTTP_PROXY_RESULT; typedef struct _WINHTTP_PROXY_RESULT_EX { DWORD cEntries; WINHTTP_PROXY_RESULT_ENTRY *pEntries; HANDLE hProxyDetectionHandle; DWORD dwProxyInterfaceAffinity; } WINHTTP_PROXY_RESULT_EX; #define NETWORKING_KEY_BUFSIZE 128 typedef struct _WinHttpProxyNetworkKey { unsigned char pbBuffer[NETWORKING_KEY_BUFSIZE]; } WINHTTP_PROXY_NETWORKING_KEY, *PWINHTTP_PROXY_NETWORKING_KEY; #define WINHTTP_PROXY_TYPE_DIRECT 0x00000001 // Direct to net #define WINHTTP_PROXY_TYPE_PROXY 0x00000002 // Via named proxy #define WINHTTP_PROXY_TYPE_AUTO_PROXY_URL 0x00000004 // Autoproxy URL #define WINHTTP_PROXY_TYPE_AUTO_DETECT 0x00000008 // Use autoproxy detection typedef struct _WINHTTP_PROXY_SETTINGS { DWORD dwStructSize; DWORD dwFlags; DWORD dwCurrentSettingsVersion; PWSTR pwszConnectionName; PWSTR pwszProxy; PWSTR pwszProxyBypass; PWSTR pwszAutoconfigUrl; PWSTR pwszAutoconfigSecondaryUrl; DWORD dwAutoDiscoveryFlags; PWSTR pwszLastKnownGoodAutoConfigUrl; DWORD dwAutoconfigReloadDelayMins; FILETIME ftLastKnownDetectTime; DWORD dwDetectedInterfaceIpCount; PDWORD pdwDetectedInterfaceIp; DWORD cNetworkKeys; PWINHTTP_PROXY_NETWORKING_KEY pNetworkKeys; } WINHTTP_PROXY_SETTINGS, *PWINHTTP_PROXY_SETTINGS; #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */ #pragma endregion #pragma region Application Family or OneCore Family or Games Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) // // WINHTTP_CERTIFICATE_INFO lpBuffer - contains the certificate returned from // the server // typedef struct _WINHTTP_CERTIFICATE_INFO { // // 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. // LPWSTR lpszSubjectInfo; // // lpszIssuerInfo - the name of organization, site, and server // the cert was issues by. // LPWSTR lpszIssuerInfo; // // lpszProtocolName - the name of the protocol used to provide the secure // connection. // LPWSTR lpszProtocolName; // // lpszSignatureAlgName - the name of the algorithm used for signing // the certificate. // LPWSTR lpszSignatureAlgName; // // lpszEncryptionAlgName - the name of the algorithm used for // doing encryption over the secure channel (SSL) connection. // LPWSTR lpszEncryptionAlgName; // // dwKeySize - size of the key. // DWORD dwKeySize; } WINHTTP_CERTIFICATE_INFO, *PWINHTTP_CERTIFICATE_INFO; #ifdef _WS2DEF_ typedef struct _WINHTTP_CONNECTION_INFO { DWORD cbSize; SOCKADDR_STORAGE LocalAddress; // local ip, local port SOCKADDR_STORAGE RemoteAddress; // remote ip, remote port } WINHTTP_CONNECTION_INFO, *PWINHTTP_CONNECTION_INFO; #endif #ifdef __SCHANNEL_H__ typedef struct _WINHTTP_SECURITY_INFO { SecPkgContext_ConnectionInfo ConnectionInfo; SecPkgContext_CipherInfo CipherInfo; } WINHTTP_SECURITY_INFO, *PWINHTTP_SECURITY_INFO; #endif typedef enum _WINHTTP_REQUEST_TIME_ENTRY { WinHttpProxyDetectionStart = 0, WinHttpProxyDetectionEnd, WinHttpConnectionAcquireStart, WinHttpConnectionAcquireWaitEnd, WinHttpConnectionAcquireEnd, WinHttpNameResolutionStart, WinHttpNameResolutionEnd, WinHttpConnectionEstablishmentStart, WinHttpConnectionEstablishmentEnd, WinHttpTlsHandshakeClientLeg1Start, WinHttpTlsHandshakeClientLeg1End, WinHttpTlsHandshakeClientLeg2Start, WinHttpTlsHandshakeClientLeg2End, WinHttpTlsHandshakeClientLeg3Start, WinHttpTlsHandshakeClientLeg3End, WinHttpStreamWaitStart, WinHttpStreamWaitEnd, WinHttpSendRequestStart, WinHttpSendRequestHeadersCompressionStart, WinHttpSendRequestHeadersCompressionEnd, WinHttpSendRequestHeadersEnd, WinHttpSendRequestEnd, WinHttpReceiveResponseStart, WinHttpReceiveResponseHeadersDecompressionStart, WinHttpReceiveResponseHeadersDecompressionEnd, WinHttpReceiveResponseHeadersEnd, WinHttpReceiveResponseBodyDecompressionDelta, WinHttpReceiveResponseEnd, WinHttpProxyTunnelStart, WinHttpProxyTunnelEnd, WinHttpProxyTlsHandshakeClientLeg1Start, WinHttpProxyTlsHandshakeClientLeg1End, WinHttpProxyTlsHandshakeClientLeg2Start, WinHttpProxyTlsHandshakeClientLeg2End, WinHttpProxyTlsHandshakeClientLeg3Start, WinHttpProxyTlsHandshakeClientLeg3End, WinHttpRequestTimeLast, WinHttpRequestTimeMax = 64 } WINHTTP_REQUEST_TIME_ENTRY; typedef struct _WINHTTP_REQUEST_TIMES { ULONG cTimes; ULONGLONG rgullTimes[WinHttpRequestTimeMax]; } WINHTTP_REQUEST_TIMES, *PWINHTTP_REQUEST_TIMES; typedef enum _WINHTTP_REQUEST_STAT_ENTRY { WinHttpConnectFailureCount = 0, WinHttpProxyFailureCount, WinHttpTlsHandshakeClientLeg1Size, WinHttpTlsHandshakeServerLeg1Size, WinHttpTlsHandshakeClientLeg2Size, WinHttpTlsHandshakeServerLeg2Size, WinHttpRequestHeadersSize, WinHttpRequestHeadersCompressedSize, WinHttpResponseHeadersSize, WinHttpResponseHeadersCompressedSize, WinHttpResponseBodySize, WinHttpResponseBodyCompressedSize, WinHttpProxyTlsHandshakeClientLeg1Size, WinHttpProxyTlsHandshakeServerLeg1Size, WinHttpProxyTlsHandshakeClientLeg2Size, WinHttpProxyTlsHandshakeServerLeg2Size, WinHttpRequestStatLast, WinHttpRequestStatMax = 32 } WINHTTP_REQUEST_STAT_ENTRY; #define WINHTTP_REQUEST_STAT_FLAG_TCP_FAST_OPEN 0x00000001 #define WINHTTP_REQUEST_STAT_FLAG_TLS_SESSION_RESUMPTION 0x00000002 #define WINHTTP_REQUEST_STAT_FLAG_TLS_FALSE_START 0x00000004 #define WINHTTP_REQUEST_STAT_FLAG_PROXY_TLS_SESSION_RESUMPTION 0x00000008 #define WINHTTP_REQUEST_STAT_FLAG_PROXY_TLS_FALSE_START 0x00000010 #define WINHTTP_REQUEST_STAT_FLAG_FIRST_REQUEST 0x00000020 typedef struct _WINHTTP_REQUEST_STATS { ULONGLONG ullFlags; ULONG ulIndex; ULONG cStats; ULONGLONG rgullStats[WinHttpRequestStatMax]; } WINHTTP_REQUEST_STATS, *PWINHTTP_REQUEST_STATS; #define WINHTTP_MATCH_CONNECTION_GUID_FLAG_REQUIRE_MARKED_CONNECTION 0x00000001 #define WINHTTP_MATCH_CONNECTION_GUID_FLAGS_MASK WINHTTP_MATCH_CONNECTION_GUID_FLAG_REQUIRE_MARKED_CONNECTION typedef struct _WINHTTP_MATCH_CONNECTION_GUID { GUID ConnectionGuid; ULONGLONG ullFlags; } WINHTTP_MATCH_CONNECTION_GUID, *PWINHTTP_MATCH_CONNECTION_GUID; #pragma warning(push) #pragma warning(disable:4201) //nameless unions typedef struct _WINHTTP_EXTENDED_HEADER { union { PCWSTR pwszName; PCSTR pszName; }; union { PCWSTR pwszValue; PCSTR pszValue; }; } WINHTTP_EXTENDED_HEADER, *PWINHTTP_EXTENDED_HEADER; #pragma warning(pop) typedef union _WINHTTP_HEADER_NAME { PCWSTR pwszName; PCSTR pszName; } WINHTTP_HEADER_NAME, *PWINHTTP_HEADER_NAME; #define WINHTTP_RESOLVER_CACHE_CONFIG_FLAG_SOFT_LIMIT 0x00000001 #define WINHTTP_RESOLVER_CACHE_CONFIG_FLAG_BYPASS_CACHE 0x00000002 #define WINHTTP_RESOLVER_CACHE_CONFIG_FLAG_USE_DNS_TTL 0x00000004 #define WINHTTP_RESOLVER_CACHE_CONFIG_FLAG_CONN_USE_TTL 0x00000008 typedef enum _WINHTTP_SECURE_DNS_SETTING { WinHttpSecureDnsSettingDefault = 0, WinHttpSecureDnsSettingForcePlaintext = 1, WinHttpSecureDnsSettingRequireEncryption = 2, WinHttpSecureDnsSettingTryEncryptionWithFallback = 3, WinHttpSecureDnsSettingMax = 4 } WINHTTP_SECURE_DNS_SETTING; typedef struct _WINHTTP_RESOLVER_CACHE_CONFIG { ULONG ulMaxResolverCacheEntries; // // ulMaxCacheEntryAge is the maximum allowed age of a cache entry specified in minutes. // ULONG ulMaxCacheEntryAge; // // ulMinCacheEntryTtl the minimum TTL of a cache entry specified in seconds. // ULONG ulMinCacheEntryTtl; WINHTTP_SECURE_DNS_SETTING SecureDnsSetting; // // If WINHTTP_RESOLVER_CACHE_CONFIG_FLAG_CONN_USE_TTL is set, then ullCOnnResolutionWaitTime // can be used to control how frequently a re-resolution attempt is made for any connection. // It is specified in 100 nanosecond units, and the default is 600000000 (one minute). // ULONGLONG ullConnResolutionWaitTime; ULONGLONG ullFlags; } WINHTTP_RESOLVER_CACHE_CONFIG, *PWINHTTP_RESOLVER_CACHE_CONFIG; // // Structures for WinHttpQueryConnectionGroup // typedef struct _WINHTTP_CONNECTION_GROUP { ULONG cConnections; GUID guidGroup; } WINHTTP_CONNECTION_GROUP, *PWINHTTP_CONNECTION_GROUP; typedef struct _WINHTTP_HOST_CONNECTION_GROUP { PCWSTR pwszHost; ULONG cConnectionGroups; PWINHTTP_CONNECTION_GROUP pConnectionGroups; } WINHTTP_HOST_CONNECTION_GROUP, *PWINHTTP_HOST_CONNECTION_GROUP; typedef struct _WINHTTP_QUERY_CONNECTION_GROUP_RESULT { ULONG cHosts; PWINHTTP_HOST_CONNECTION_GROUP pHostConnectionGroups; } WINHTTP_QUERY_CONNECTION_GROUP_RESULT, *PWINHTTP_QUERY_CONNECTION_GROUP_RESULT; #define WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE 0x0000000000000001ull typedef struct _WINHTTP_HTTP2_RECEIVE_WINDOW { ULONG ulStreamWindow; ULONG ulStreamWindowUpdateDelta; } WINHTTP_HTTP2_RECEIVE_WINDOW, *PWINHTTP_HTTP2_RECEIVE_WINDOW; // // constants for WinHttpTimeFromSystemTime // #define WINHTTP_TIME_FORMAT_BUFSIZE 62 // // options manifests for WinHttp{Query|Set}Option // #define WINHTTP_FIRST_OPTION WINHTTP_OPTION_CALLBACK #define WINHTTP_OPTION_CALLBACK 1 #define WINHTTP_OPTION_RESOLVE_TIMEOUT 2 #define WINHTTP_OPTION_CONNECT_TIMEOUT 3 #define WINHTTP_OPTION_CONNECT_RETRIES 4 #define WINHTTP_OPTION_SEND_TIMEOUT 5 #define WINHTTP_OPTION_RECEIVE_TIMEOUT 6 #define WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT 7 #define WINHTTP_OPTION_HANDLE_TYPE 9 #define WINHTTP_OPTION_READ_BUFFER_SIZE 12 #define WINHTTP_OPTION_WRITE_BUFFER_SIZE 13 #define WINHTTP_OPTION_PARENT_HANDLE 21 #define WINHTTP_OPTION_EXTENDED_ERROR 24 #define WINHTTP_OPTION_SECURITY_FLAGS 31 #define WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT 32 #define WINHTTP_OPTION_URL 34 #define WINHTTP_OPTION_SECURITY_KEY_BITNESS 36 #define WINHTTP_OPTION_PROXY 38 #define WINHTTP_OPTION_PROXY_RESULT_ENTRY 39 #define WINHTTP_OPTION_USER_AGENT 41 #define WINHTTP_OPTION_CONTEXT_VALUE 45 #define WINHTTP_OPTION_CLIENT_CERT_CONTEXT 47 #define WINHTTP_OPTION_REQUEST_PRIORITY 58 #define WINHTTP_OPTION_HTTP_VERSION 59 #define WINHTTP_OPTION_DISABLE_FEATURE 63 #define WINHTTP_OPTION_CODEPAGE 68 #define WINHTTP_OPTION_MAX_CONNS_PER_SERVER 73 #define WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER 74 #define WINHTTP_OPTION_AUTOLOGON_POLICY 77 #define WINHTTP_OPTION_SERVER_CERT_CONTEXT 78 #define WINHTTP_OPTION_ENABLE_FEATURE 79 #define WINHTTP_OPTION_WORKER_THREAD_COUNT 80 #define WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT 81 #define WINHTTP_OPTION_PASSPORT_COBRANDING_URL 82 #define WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH 83 #define WINHTTP_OPTION_SECURE_PROTOCOLS 84 #define WINHTTP_OPTION_ENABLETRACING 85 #define WINHTTP_OPTION_PASSPORT_SIGN_OUT 86 #define WINHTTP_OPTION_PASSPORT_RETURN_URL 87 #define WINHTTP_OPTION_REDIRECT_POLICY 88 #define WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS 89 #define WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE 90 #define WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE 91 #define WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE 92 #define WINHTTP_OPTION_CONNECTION_INFO 93 #define WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST 94 #define WINHTTP_OPTION_SPN 96 #define WINHTTP_OPTION_GLOBAL_PROXY_CREDS 97 #define WINHTTP_OPTION_GLOBAL_SERVER_CREDS 98 #define WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT 99 #define WINHTTP_OPTION_REJECT_USERPWD_IN_URL 100 #define WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS 101 #define WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE 103 #define WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE 104 #define WINHTTP_OPTION_SERVER_SPN_USED 106 #define WINHTTP_OPTION_PROXY_SPN_USED 107 #define WINHTTP_OPTION_SERVER_CBT 108 #define WINHTTP_OPTION_UNSAFE_HEADER_PARSING 110 #define WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS 111 #define WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET 114 #define WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT 115 #define WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL 116 #define WINHTTP_OPTION_DECOMPRESSION 118 #define WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE 122 #define WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE 123 #define WINHTTP_OPTION_TCP_PRIORITY_HINT 128 #define WINHTTP_OPTION_CONNECTION_FILTER 131 #define WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL 133 #define WINHTTP_OPTION_HTTP_PROTOCOL_USED 134 #define WINHTTP_OPTION_KDC_PROXY_SETTINGS 136 #define WINHTTP_OPTION_PROXY_DISABLE_SERVICE_CALLS 137 #define WINHTTP_OPTION_ENCODE_EXTRA 138 #define WINHTTP_OPTION_DISABLE_STREAM_QUEUE 139 #define WINHTTP_OPTION_IPV6_FAST_FALLBACK 140 #define WINHTTP_OPTION_CONNECTION_STATS_V0 141 #define WINHTTP_OPTION_REQUEST_TIMES 142 #define WINHTTP_OPTION_EXPIRE_CONNECTION 143 #define WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK 144 #define WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED 145 #define WINHTTP_OPTION_REQUEST_STATS 146 #define WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT 147 #define WINHTTP_OPTION_CONNECTION_STATS_V1 150 #define WINHTTP_OPTION_SECURITY_INFO 151 #define WINHTTP_OPTION_TCP_KEEPALIVE 152 #define WINHTTP_OPTION_TCP_FAST_OPEN 153 #define WINHTTP_OPTION_TLS_FALSE_START 154 #define WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE 155 #define WINHTTP_OPTION_SOURCE_ADDRESS 156 #define WINHTTP_OPTION_HEAP_EXTENSION 157 #define WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK 158 #define WINHTTP_OPTION_STREAM_ERROR_CODE 159 #define WINHTTP_OPTION_REQUIRE_STREAM_END 160 #define WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT 161 #define WINHTTP_OPTION_FAILED_CONNECTION_RETRIES 162 #define WINHTTP_OPTION_SET_GLOBAL_CALLBACK 163 #define WINHTTP_OPTION_HTTP2_KEEPALIVE 164 #define WINHTTP_OPTION_RESOLUTION_HOSTNAME 165 #define WINHTTP_OPTION_SET_TOKEN_BINDING 166 #define WINHTTP_OPTION_TOKEN_BINDING_PUBLIC_KEY 167 #define WINHTTP_OPTION_REFERER_TOKEN_BINDING_HOSTNAME 168 #define WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING 169 #define WINHTTP_OPTION_RESOLVER_CACHE_CONFIG 170 #define WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING 171 #define WINHTTP_OPTION_BACKGROUND_CONNECTIONS 172 #define WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION 173 #define WINHTTP_OPTION_ENABLE_TEST_SIGNING 174 #define WINHTTP_OPTION_NTSERVICE_FLAG_TEST 175 #define WINHTTP_OPTION_DISABLE_PROXY_LINK_LOCAL_NAME_RESOLUTION 176 #define WINHTTP_OPTION_TCP_PRIORITY_STATUS 177 #define WINHTTP_OPTION_CONNECTION_GUID 178 #define WINHTTP_OPTION_MATCH_CONNECTION_GUID 179 #define WINHTTP_OPTION_PROXY_CONFIG_INFO 180 #define WINHTTP_OPTION_AGGREGATE_PROXY_CONFIG 181 #define WINHTTP_OPTION_SELECTED_PROXY_CONFIG_INFO 182 #define WINHTTP_OPTION_HTTP2_RECEIVE_WINDOW 183 #define WINHTTP_LAST_OPTION WINHTTP_OPTION_HTTP2_RECEIVE_WINDOW #define WINHTTP_OPTION_USERNAME 0x1000 #define WINHTTP_OPTION_PASSWORD 0x1001 #define WINHTTP_OPTION_PROXY_USERNAME 0x1002 #define WINHTTP_OPTION_PROXY_PASSWORD 0x1003 // manifest value for WINHTTP_OPTION_MAX_CONNS_PER_SERVER and WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER #define WINHTTP_CONNS_PER_SERVER_UNLIMITED 0xFFFFFFFF #define WINHTTP_CONNECTION_RETRY_CONDITION_408 0x1 #define WINHTTP_CONNECTION_RETRY_CONDITION_SSL_HANDSHAKE 0x2 #define WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION 0x4 #define WINHTTP_CONNECTION_RETRY_CONDITION_MASK \ (WINHTTP_CONNECTION_RETRY_CONDITION_408 | \ WINHTTP_CONNECTION_RETRY_CONDITION_SSL_HANDSHAKE | \ WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION) \ typedef struct _WINHTTP_FAILED_CONNECTION_RETRIES { DWORD dwMaxRetries; DWORD dwAllowedRetryConditions; } WINHTTP_FAILED_CONNECTION_RETRIES, *PWINHTTP_FAILED_CONNECTION_RETRIES; // // Values for WINHTTP_OPTION_DECOMPRESSION // #define WINHTTP_DECOMPRESSION_FLAG_GZIP 0x00000001 #define WINHTTP_DECOMPRESSION_FLAG_DEFLATE 0x00000002 #define WINHTTP_DECOMPRESSION_FLAG_ALL ( \ WINHTTP_DECOMPRESSION_FLAG_GZIP | \ WINHTTP_DECOMPRESSION_FLAG_DEFLATE) // // Values for WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL / WINHTTP_OPTION_HTTP_PROTOCOL_USED // #define WINHTTP_PROTOCOL_FLAG_HTTP2 0x1 #define WINHTTP_PROTOCOL_FLAG_HTTP3 0x2 #define WINHTTP_PROTOCOL_MASK (WINHTTP_PROTOCOL_FLAG_HTTP2 | WINHTTP_PROTOCOL_FLAG_HTTP3) // values for WINHTTP_OPTION_AUTOLOGON_POLICY #define WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM 0 #define WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW 1 #define WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH 2 #define WINHTTP_AUTOLOGON_SECURITY_LEVEL_DEFAULT WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM // values for WINHTTP_OPTION_REDIRECT_POLICY #define WINHTTP_OPTION_REDIRECT_POLICY_NEVER 0 #define WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP 1 #define WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS 2 #define WINHTTP_OPTION_REDIRECT_POLICY_LAST WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS #define WINHTTP_OPTION_REDIRECT_POLICY_DEFAULT WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP #define WINHTTP_DISABLE_PASSPORT_AUTH 0x00000000 #define WINHTTP_ENABLE_PASSPORT_AUTH 0x10000000 #define WINHTTP_DISABLE_PASSPORT_KEYRING 0x20000000 #define WINHTTP_ENABLE_PASSPORT_KEYRING 0x40000000 // values for WINHTTP_OPTION_DISABLE_FEATURE #define WINHTTP_DISABLE_COOKIES 0x00000001 #define WINHTTP_DISABLE_REDIRECTS 0x00000002 #define WINHTTP_DISABLE_AUTHENTICATION 0x00000004 #define WINHTTP_DISABLE_KEEP_ALIVE 0x00000008 // values for WINHTTP_OPTION_ENABLE_FEATURE #define WINHTTP_ENABLE_SSL_REVOCATION 0x00000001 #define WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION 0x00000002 // values for WINHTTP_OPTION_SPN #define WINHTTP_DISABLE_SPN_SERVER_PORT 0x00000000 #define WINHTTP_ENABLE_SPN_SERVER_PORT 0x00000001 #define WINHTTP_OPTION_SPN_MASK WINHTTP_ENABLE_SPN_SERVER_PORT typedef struct tagWINHTTP_CREDS { LPSTR lpszUserName; LPSTR lpszPassword; LPSTR lpszRealm; DWORD dwAuthScheme; LPSTR lpszHostName; DWORD dwPort; } WINHTTP_CREDS, *PWINHTTP_CREDS; // structure for WINHTTP_OPTION_GLOBAL_SERVER_CREDS and // WINHTTP_OPTION_GLOBAL_PROXY_CREDS typedef struct tagWINHTTP_CREDS_EX { LPSTR lpszUserName; LPSTR lpszPassword; LPSTR lpszRealm; DWORD dwAuthScheme; LPSTR lpszHostName; DWORD dwPort; LPSTR lpszUrl; } WINHTTP_CREDS_EX, *PWINHTTP_CREDS_EX; // // winhttp handle types // #define WINHTTP_HANDLE_TYPE_SESSION 1 #define WINHTTP_HANDLE_TYPE_CONNECT 2 #define WINHTTP_HANDLE_TYPE_REQUEST 3 // // values for auth schemes // #define WINHTTP_AUTH_SCHEME_BASIC 0x00000001 #define WINHTTP_AUTH_SCHEME_NTLM 0x00000002 #define WINHTTP_AUTH_SCHEME_PASSPORT 0x00000004 #define WINHTTP_AUTH_SCHEME_DIGEST 0x00000008 #define WINHTTP_AUTH_SCHEME_NEGOTIATE 0x00000010 // WinHttp supported Authentication Targets #define WINHTTP_AUTH_TARGET_SERVER 0x00000000 #define WINHTTP_AUTH_TARGET_PROXY 0x00000001 // // values for WINHTTP_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 // Secure connection error status flags #define WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED 0x00000001 #define WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CERT 0x00000002 #define WINHTTP_CALLBACK_STATUS_FLAG_CERT_REVOKED 0x00000004 #define WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA 0x00000008 #define WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID 0x00000010 #define WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID 0x00000020 #define WINHTTP_CALLBACK_STATUS_FLAG_CERT_WRONG_USAGE 0x00000040 #define WINHTTP_CALLBACK_STATUS_FLAG_SECURITY_CHANNEL_ERROR 0x80000000 #define WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 0x00000008 #define WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 0x00000020 #define WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 0x00000080 #define WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_1 0x00000200 #define WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_2 0x00000800 #define WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_3 0x00002000 #define WINHTTP_FLAG_SECURE_PROTOCOL_ALL (WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 | \ WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 | \ WINHTTP_FLAG_SECURE_PROTOCOL_TLS1) // // callback function for WinHttpSetStatusCallback // typedef VOID (CALLBACK * WINHTTP_STATUS_CALLBACK)( IN HINTERNET hInternet, IN DWORD_PTR dwContext, IN DWORD dwInternetStatus, IN LPVOID lpvStatusInformation OPTIONAL, IN DWORD dwStatusInformationLength ); typedef WINHTTP_STATUS_CALLBACK * LPWINHTTP_STATUS_CALLBACK; // // status manifests for WinHttp status callback // #define WINHTTP_CALLBACK_STATUS_RESOLVING_NAME 0x00000001 #define WINHTTP_CALLBACK_STATUS_NAME_RESOLVED 0x00000002 #define WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER 0x00000004 #define WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER 0x00000008 #define WINHTTP_CALLBACK_STATUS_SENDING_REQUEST 0x00000010 #define WINHTTP_CALLBACK_STATUS_REQUEST_SENT 0x00000020 #define WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE 0x00000040 #define WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED 0x00000080 #define WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION 0x00000100 #define WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED 0x00000200 #define WINHTTP_CALLBACK_STATUS_HANDLE_CREATED 0x00000400 #define WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING 0x00000800 #define WINHTTP_CALLBACK_STATUS_DETECTING_PROXY 0x00001000 #define WINHTTP_CALLBACK_STATUS_REDIRECT 0x00004000 #define WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE 0x00008000 #define WINHTTP_CALLBACK_STATUS_SECURE_FAILURE 0x00010000 #define WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE 0x00020000 #define WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE 0x00040000 #define WINHTTP_CALLBACK_STATUS_READ_COMPLETE 0x00080000 #define WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE 0x00100000 #define WINHTTP_CALLBACK_STATUS_REQUEST_ERROR 0x00200000 #define WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE 0x00400000 #define WINHTTP_CALLBACK_STATUS_GETPROXYFORURL_COMPLETE 0x01000000 #define WINHTTP_CALLBACK_STATUS_CLOSE_COMPLETE 0x02000000 #define WINHTTP_CALLBACK_STATUS_SHUTDOWN_COMPLETE 0x04000000 #define WINHTTP_CALLBACK_STATUS_SETTINGS_WRITE_COMPLETE 0x10000000 #define WINHTTP_CALLBACK_STATUS_SETTINGS_READ_COMPLETE 0x20000000 // API Enums for WINHTTP_CALLBACK_STATUS_REQUEST_ERROR: #define API_RECEIVE_RESPONSE (1) #define API_QUERY_DATA_AVAILABLE (2) #define API_READ_DATA (3) #define API_WRITE_DATA (4) #define API_SEND_REQUEST (5) #define API_GET_PROXY_FOR_URL (6) #define WINHTTP_CALLBACK_FLAG_RESOLVE_NAME (WINHTTP_CALLBACK_STATUS_RESOLVING_NAME | WINHTTP_CALLBACK_STATUS_NAME_RESOLVED) #define WINHTTP_CALLBACK_FLAG_CONNECT_TO_SERVER (WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER | WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER) #define WINHTTP_CALLBACK_FLAG_SEND_REQUEST (WINHTTP_CALLBACK_STATUS_SENDING_REQUEST | WINHTTP_CALLBACK_STATUS_REQUEST_SENT) #define WINHTTP_CALLBACK_FLAG_RECEIVE_RESPONSE (WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE | WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED) #define WINHTTP_CALLBACK_FLAG_CLOSE_CONNECTION (WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION | WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED) #define WINHTTP_CALLBACK_FLAG_HANDLES (WINHTTP_CALLBACK_STATUS_HANDLE_CREATED | WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING) #define WINHTTP_CALLBACK_FLAG_DETECTING_PROXY WINHTTP_CALLBACK_STATUS_DETECTING_PROXY #define WINHTTP_CALLBACK_FLAG_REDIRECT WINHTTP_CALLBACK_STATUS_REDIRECT #define WINHTTP_CALLBACK_FLAG_INTERMEDIATE_RESPONSE WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE #define WINHTTP_CALLBACK_FLAG_SECURE_FAILURE WINHTTP_CALLBACK_STATUS_SECURE_FAILURE #define WINHTTP_CALLBACK_FLAG_SENDREQUEST_COMPLETE WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE #define WINHTTP_CALLBACK_FLAG_HEADERS_AVAILABLE WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE #define WINHTTP_CALLBACK_FLAG_DATA_AVAILABLE WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE #define WINHTTP_CALLBACK_FLAG_READ_COMPLETE WINHTTP_CALLBACK_STATUS_READ_COMPLETE #define WINHTTP_CALLBACK_FLAG_WRITE_COMPLETE WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE #define WINHTTP_CALLBACK_FLAG_REQUEST_ERROR WINHTTP_CALLBACK_STATUS_REQUEST_ERROR #define WINHTTP_CALLBACK_FLAG_GETPROXYFORURL_COMPLETE WINHTTP_CALLBACK_STATUS_GETPROXYFORURL_COMPLETE #define WINHTTP_CALLBACK_FLAG_ALL_COMPLETIONS (WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE \ | WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE \ | WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE \ | WINHTTP_CALLBACK_STATUS_READ_COMPLETE \ | WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE \ | WINHTTP_CALLBACK_STATUS_REQUEST_ERROR \ | WINHTTP_CALLBACK_STATUS_GETPROXYFORURL_COMPLETE) #define WINHTTP_CALLBACK_FLAG_ALL_NOTIFICATIONS 0xffffffff // // if the following value is returned by WinHttpSetStatusCallback, then // probably an invalid (non-code) address was supplied for the callback // #define WINHTTP_INVALID_STATUS_CALLBACK ((WINHTTP_STATUS_CALLBACK)(-1L)) // // WinHttpQueryHeaders 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 WINHTTP_QUERY_RAW_HEADERS info level is provided for clients // that choose to perform their own header parsing. // #define WINHTTP_QUERY_MIME_VERSION 0 #define WINHTTP_QUERY_CONTENT_TYPE 1 #define WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING 2 #define WINHTTP_QUERY_CONTENT_ID 3 #define WINHTTP_QUERY_CONTENT_DESCRIPTION 4 #define WINHTTP_QUERY_CONTENT_LENGTH 5 #define WINHTTP_QUERY_CONTENT_LANGUAGE 6 #define WINHTTP_QUERY_ALLOW 7 #define WINHTTP_QUERY_PUBLIC 8 #define WINHTTP_QUERY_DATE 9 #define WINHTTP_QUERY_EXPIRES 10 #define WINHTTP_QUERY_LAST_MODIFIED 11 #define WINHTTP_QUERY_MESSAGE_ID 12 #define WINHTTP_QUERY_URI 13 #define WINHTTP_QUERY_DERIVED_FROM 14 #define WINHTTP_QUERY_COST 15 #define WINHTTP_QUERY_LINK 16 #define WINHTTP_QUERY_PRAGMA 17 #define WINHTTP_QUERY_VERSION 18 // special: part of status line #define WINHTTP_QUERY_STATUS_CODE 19 // special: part of status line #define WINHTTP_QUERY_STATUS_TEXT 20 // special: part of status line #define WINHTTP_QUERY_RAW_HEADERS 21 // special: all headers as ASCIIZ #define WINHTTP_QUERY_RAW_HEADERS_CRLF 22 // special: all headers #define WINHTTP_QUERY_CONNECTION 23 #define WINHTTP_QUERY_ACCEPT 24 #define WINHTTP_QUERY_ACCEPT_CHARSET 25 #define WINHTTP_QUERY_ACCEPT_ENCODING 26 #define WINHTTP_QUERY_ACCEPT_LANGUAGE 27 #define WINHTTP_QUERY_AUTHORIZATION 28 #define WINHTTP_QUERY_CONTENT_ENCODING 29 #define WINHTTP_QUERY_FORWARDED 30 #define WINHTTP_QUERY_FROM 31 #define WINHTTP_QUERY_IF_MODIFIED_SINCE 32 #define WINHTTP_QUERY_LOCATION 33 #define WINHTTP_QUERY_ORIG_URI 34 #define WINHTTP_QUERY_REFERER 35 #define WINHTTP_QUERY_RETRY_AFTER 36 #define WINHTTP_QUERY_SERVER 37 #define WINHTTP_QUERY_TITLE 38 #define WINHTTP_QUERY_USER_AGENT 39 #define WINHTTP_QUERY_WWW_AUTHENTICATE 40 #define WINHTTP_QUERY_PROXY_AUTHENTICATE 41 #define WINHTTP_QUERY_ACCEPT_RANGES 42 #define WINHTTP_QUERY_SET_COOKIE 43 #define WINHTTP_QUERY_COOKIE 44 #define WINHTTP_QUERY_REQUEST_METHOD 45 // special: GET/POST etc. #define WINHTTP_QUERY_REFRESH 46 #define WINHTTP_QUERY_CONTENT_DISPOSITION 47 // // HTTP 1.1 defined headers // #define WINHTTP_QUERY_AGE 48 #define WINHTTP_QUERY_CACHE_CONTROL 49 #define WINHTTP_QUERY_CONTENT_BASE 50 #define WINHTTP_QUERY_CONTENT_LOCATION 51 #define WINHTTP_QUERY_CONTENT_MD5 52 #define WINHTTP_QUERY_CONTENT_RANGE 53 #define WINHTTP_QUERY_ETAG 54 #define WINHTTP_QUERY_HOST 55 #define WINHTTP_QUERY_IF_MATCH 56 #define WINHTTP_QUERY_IF_NONE_MATCH 57 #define WINHTTP_QUERY_IF_RANGE 58 #define WINHTTP_QUERY_IF_UNMODIFIED_SINCE 59 #define WINHTTP_QUERY_MAX_FORWARDS 60 #define WINHTTP_QUERY_PROXY_AUTHORIZATION 61 #define WINHTTP_QUERY_RANGE 62 #define WINHTTP_QUERY_TRANSFER_ENCODING 63 #define WINHTTP_QUERY_UPGRADE 64 #define WINHTTP_QUERY_VARY 65 #define WINHTTP_QUERY_VIA 66 #define WINHTTP_QUERY_WARNING 67 #define WINHTTP_QUERY_EXPECT 68 #define WINHTTP_QUERY_PROXY_CONNECTION 69 #define WINHTTP_QUERY_UNLESS_MODIFIED_SINCE 70 #define WINHTTP_QUERY_PROXY_SUPPORT 75 #define WINHTTP_QUERY_AUTHENTICATION_INFO 76 #define WINHTTP_QUERY_PASSPORT_URLS 77 #define WINHTTP_QUERY_PASSPORT_CONFIG 78 #define WINHTTP_QUERY_MAX 78 #define WINHTTP_QUERY_EX_ALL_HEADERS WINHTTP_QUERY_RAW_HEADERS // // WINHTTP_QUERY_CUSTOM - if this special value is supplied as the dwInfoLevel // parameter of WinHttpQueryHeaders() then the lpBuffer parameter contains the name // of the header we are to query // #define WINHTTP_QUERY_CUSTOM 65535 // // WINHTTP_QUERY_FLAG_REQUEST_HEADERS - if this bit is set in the dwInfoLevel // parameter of WinHttpQueryHeaders() then the request headers will be queried for the // request information // #define WINHTTP_QUERY_FLAG_REQUEST_HEADERS 0x80000000 // // WINHTTP_QUERY_FLAG_SYSTEMTIME - if this bit is set in the dwInfoLevel parameter // of WinHttpQueryHeaders() 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 WINHTTP_QUERY_FLAG_SYSTEMTIME 0x40000000 // // WINHTTP_QUERY_FLAG_NUMBER - if this bit is set in the dwInfoLevel parameter of // HttpQueryHeader(), then the value of the header will be converted to a number // before being returned to the caller, if applicable // #define WINHTTP_QUERY_FLAG_NUMBER 0x20000000 // // 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 WINHTTP_QUERY_FLAG_NUMBER64 0x08000000 // // HTTP_QUERY_FLAG_TRAILERS - if this bit is set in the dwInfoLevel parameter of // WinHttpQueryHeaders(), then the response trailers will be queried, if they exist // #define WINHTTP_QUERY_FLAG_TRAILERS 0x02000000 // // WINHTTP_QUERY_FLAG_WIRE_ENCODING - if this bit is set in the dwInfoLevel parameter // of WinHttpQueryHeaders(), then the value of the header will be returned // with as it gets encoded when sent over the wire. // #define WINHTTP_QUERY_FLAG_WIRE_ENCODING 0x01000000 // // 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 fulfilled #define HTTP_STATUS_WEBDAV_MULTI_STATUS 207 // WebDAV Multi-Status #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_PERMANENT_REDIRECT 308 // Object permanently moved keep 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 // // flags for CrackUrl() and CombineUrl() // #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. // // flags for WinHttpCrackUrl() and WinHttpCreateUrl() // #define ICU_ESCAPE 0x80000000 // (un)escape URL characters #define ICU_ESCAPE_AUTHORITY 0x00002000 //causes InternetCreateUrlA to escape chars in authority components (user, pwd, host) #define ICU_REJECT_USERPWD 0x00004000 // rejects usrls whick have username/pwd sections // WinHttpOpen dwAccessType values (also for WINHTTP_PROXY_INFO::dwAccessType) #define WINHTTP_ACCESS_TYPE_DEFAULT_PROXY 0 #define WINHTTP_ACCESS_TYPE_NO_PROXY 1 #define WINHTTP_ACCESS_TYPE_NAMED_PROXY 3 #define WINHTTP_ACCESS_TYPE_AUTOMATIC_PROXY 4 // WinHttpOpen prettifiers for optional parameters #define WINHTTP_NO_PROXY_NAME NULL #define WINHTTP_NO_PROXY_BYPASS NULL #define WINHTTP_NO_CLIENT_CERT_CONTEXT NULL // WinHttpOpenRequest prettifers for optional parameters #define WINHTTP_NO_REFERER NULL #define WINHTTP_DEFAULT_ACCEPT_TYPES NULL // // values for dwModifiers parameter of WinHttpAddRequestHeaders() // #define WINHTTP_ADDREQ_INDEX_MASK 0x0000FFFF #define WINHTTP_ADDREQ_FLAGS_MASK 0xFFFF0000 // // WINHTTP_ADDREQ_FLAG_ADD_IF_NEW - the header will only be added if it doesn't // already exist // #define WINHTTP_ADDREQ_FLAG_ADD_IF_NEW 0x10000000 // // WINHTTP_ADDREQ_FLAG_ADD - if WINHTTP_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 WINHTTP_ADDREQ_FLAG_ADD 0x20000000 // // WINHTTP_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 WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA 0x40000000 #define WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON 0x01000000 #define WINHTTP_ADDREQ_FLAG_COALESCE WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA // // WINHTTP_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 WINHTTP_ADDREQ_FLAG_REPLACE 0x80000000 // // values for ullFlags member of WINHTTP_EXTENDED_HEADER // // // WINHTTP_EXTENDED_HEADER_FLAG_UNICODE - indicates the value of the request header // is unicode. // #define WINHTTP_EXTENDED_HEADER_FLAG_UNICODE 0x00000001 // // values for ullFlags for WinHttpReadDataEx // // // WINHTTP_READ_DATA_EX_FLAG_FILL_BUFFER - if set, don't complete ReadDataEx // until the data buffer has been filled or the response is complete. // #define WINHTTP_READ_DATA_EX_FLAG_FILL_BUFFER 0x0000000000000001ull #define WINHTTP_IGNORE_REQUEST_TOTAL_LENGTH 0 // WinHttpSendRequest prettifiers for optional parameters. #define WINHTTP_NO_ADDITIONAL_HEADERS NULL #define WINHTTP_NO_REQUEST_DATA NULL // WinHttpQueryHeaders prettifiers for optional parameters. #define WINHTTP_HEADER_NAME_BY_INDEX NULL #define WINHTTP_NO_OUTPUT_BUFFER NULL #define WINHTTP_NO_HEADER_INDEX NULL #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) */ #pragma endregion #pragma region Application Family or OneCore Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) typedef struct _WINHTTP_CURRENT_USER_IE_PROXY_CONFIG { BOOL fAutoDetect; LPWSTR lpszAutoConfigUrl; LPWSTR lpszProxy; LPWSTR lpszProxyBypass; } WINHTTP_CURRENT_USER_IE_PROXY_CONFIG, *PWINHTTP_CURRENT_USER_IE_PROXY_CONFIG; #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */ #pragma endregion #pragma region Application Family or OneCore Family or Games Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) //#if !defined(_WINERROR_) // // WinHttp API error returns // #define WINHTTP_ERROR_BASE 12000 #define ERROR_WINHTTP_OUT_OF_HANDLES (WINHTTP_ERROR_BASE + 1) #define ERROR_WINHTTP_TIMEOUT (WINHTTP_ERROR_BASE + 2) #define ERROR_WINHTTP_INTERNAL_ERROR (WINHTTP_ERROR_BASE + 4) #define ERROR_WINHTTP_INVALID_URL (WINHTTP_ERROR_BASE + 5) #define ERROR_WINHTTP_UNRECOGNIZED_SCHEME (WINHTTP_ERROR_BASE + 6) #define ERROR_WINHTTP_NAME_NOT_RESOLVED (WINHTTP_ERROR_BASE + 7) #define ERROR_WINHTTP_INVALID_OPTION (WINHTTP_ERROR_BASE + 9) #define ERROR_WINHTTP_OPTION_NOT_SETTABLE (WINHTTP_ERROR_BASE + 11) #define ERROR_WINHTTP_SHUTDOWN (WINHTTP_ERROR_BASE + 12) #define ERROR_WINHTTP_LOGIN_FAILURE (WINHTTP_ERROR_BASE + 15) #define ERROR_WINHTTP_OPERATION_CANCELLED (WINHTTP_ERROR_BASE + 17) #define ERROR_WINHTTP_INCORRECT_HANDLE_TYPE (WINHTTP_ERROR_BASE + 18) #define ERROR_WINHTTP_INCORRECT_HANDLE_STATE (WINHTTP_ERROR_BASE + 19) #define ERROR_WINHTTP_CANNOT_CONNECT (WINHTTP_ERROR_BASE + 29) #define ERROR_WINHTTP_CONNECTION_ERROR (WINHTTP_ERROR_BASE + 30) #define ERROR_WINHTTP_RESEND_REQUEST (WINHTTP_ERROR_BASE + 32) #define ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED (WINHTTP_ERROR_BASE + 44) // // WinHttpRequest Component errors // #define ERROR_WINHTTP_CANNOT_CALL_BEFORE_OPEN (WINHTTP_ERROR_BASE + 100) #define ERROR_WINHTTP_CANNOT_CALL_BEFORE_SEND (WINHTTP_ERROR_BASE + 101) #define ERROR_WINHTTP_CANNOT_CALL_AFTER_SEND (WINHTTP_ERROR_BASE + 102) #define ERROR_WINHTTP_CANNOT_CALL_AFTER_OPEN (WINHTTP_ERROR_BASE + 103) // // HTTP API errors // #define ERROR_WINHTTP_HEADER_NOT_FOUND (WINHTTP_ERROR_BASE + 150) #define ERROR_WINHTTP_INVALID_SERVER_RESPONSE (WINHTTP_ERROR_BASE + 152) #define ERROR_WINHTTP_INVALID_HEADER (WINHTTP_ERROR_BASE + 153) #define ERROR_WINHTTP_INVALID_QUERY_REQUEST (WINHTTP_ERROR_BASE + 154) #define ERROR_WINHTTP_HEADER_ALREADY_EXISTS (WINHTTP_ERROR_BASE + 155) #define ERROR_WINHTTP_REDIRECT_FAILED (WINHTTP_ERROR_BASE + 156) // // additional WinHttp API error codes // // // additional WinHttp API error codes // #define ERROR_WINHTTP_AUTO_PROXY_SERVICE_ERROR (WINHTTP_ERROR_BASE + 178) #define ERROR_WINHTTP_BAD_AUTO_PROXY_SCRIPT (WINHTTP_ERROR_BASE + 166) #define ERROR_WINHTTP_UNABLE_TO_DOWNLOAD_SCRIPT (WINHTTP_ERROR_BASE + 167) #define ERROR_WINHTTP_UNHANDLED_SCRIPT_TYPE (WINHTTP_ERROR_BASE + 176) #define ERROR_WINHTTP_SCRIPT_EXECUTION_ERROR (WINHTTP_ERROR_BASE + 177) #define ERROR_WINHTTP_NOT_INITIALIZED (WINHTTP_ERROR_BASE + 172) #define ERROR_WINHTTP_SECURE_FAILURE (WINHTTP_ERROR_BASE + 175) // // Certificate security errors. These are raised only by the WinHttpRequest // component. The WinHTTP Win32 API will return ERROR_WINHTTP_SECURE_FAILE and // provide additional information via the WINHTTP_CALLBACK_STATUS_SECURE_FAILURE // callback notification. // #define ERROR_WINHTTP_SECURE_CERT_DATE_INVALID (WINHTTP_ERROR_BASE + 37) #define ERROR_WINHTTP_SECURE_CERT_CN_INVALID (WINHTTP_ERROR_BASE + 38) #define ERROR_WINHTTP_SECURE_INVALID_CA (WINHTTP_ERROR_BASE + 45) #define ERROR_WINHTTP_SECURE_CERT_REV_FAILED (WINHTTP_ERROR_BASE + 57) #define ERROR_WINHTTP_SECURE_CHANNEL_ERROR (WINHTTP_ERROR_BASE + 157) #define ERROR_WINHTTP_SECURE_INVALID_CERT (WINHTTP_ERROR_BASE + 169) #define ERROR_WINHTTP_SECURE_CERT_REVOKED (WINHTTP_ERROR_BASE + 170) #define ERROR_WINHTTP_SECURE_CERT_WRONG_USAGE (WINHTTP_ERROR_BASE + 179) #define ERROR_WINHTTP_AUTODETECTION_FAILED (WINHTTP_ERROR_BASE + 180) #define ERROR_WINHTTP_HEADER_COUNT_EXCEEDED (WINHTTP_ERROR_BASE + 181) #define ERROR_WINHTTP_HEADER_SIZE_OVERFLOW (WINHTTP_ERROR_BASE + 182) #define ERROR_WINHTTP_CHUNKED_ENCODING_HEADER_SIZE_OVERFLOW (WINHTTP_ERROR_BASE + 183) #define ERROR_WINHTTP_RESPONSE_DRAIN_OVERFLOW (WINHTTP_ERROR_BASE + 184) #define ERROR_WINHTTP_CLIENT_CERT_NO_PRIVATE_KEY (WINHTTP_ERROR_BASE + 185) #define ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRIVATE_KEY (WINHTTP_ERROR_BASE + 186) #define ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED_PROXY (WINHTTP_ERROR_BASE + 187) #define ERROR_WINHTTP_SECURE_FAILURE_PROXY (WINHTTP_ERROR_BASE + 188) #define ERROR_WINHTTP_RESERVED_189 (WINHTTP_ERROR_BASE + 189) #define ERROR_WINHTTP_HTTP_PROTOCOL_MISMATCH (WINHTTP_ERROR_BASE + 190) #define ERROR_WINHTTP_GLOBAL_CALLBACK_FAILED (WINHTTP_ERROR_BASE + 191) #define ERROR_WINHTTP_FEATURE_DISABLED (WINHTTP_ERROR_BASE + 192) #define WINHTTP_ERROR_LAST ERROR_WINHTTP_FEATURE_DISABLED #define WINHTTP_RESET_STATE 0x00000001 #define WINHTTP_RESET_SWPAD_CURRENT_NETWORK 0x00000002 #define WINHTTP_RESET_SWPAD_ALL 0x00000004 #define WINHTTP_RESET_SCRIPT_CACHE 0x00000008 #define WINHTTP_RESET_ALL 0x0000FFFF #define WINHTTP_RESET_NOTIFY_NETWORK_CHANGED 0x00010000 #define WINHTTP_RESET_OUT_OF_PROC 0x00020000 #define WINHTTP_RESET_DISCARD_RESOLVERS 0x00040000 //#endif // !defined(_WINERROR_) // // prototypes // WINHTTPAPI WINHTTP_STATUS_CALLBACK WINAPI WinHttpSetStatusCallback ( IN HINTERNET hInternet, IN WINHTTP_STATUS_CALLBACK lpfnInternetCallback, IN DWORD dwNotificationFlags, IN DWORD_PTR dwReserved ); BOOLAPI WinHttpTimeFromSystemTime ( _In_ CONST SYSTEMTIME *pst, // input GMT time _Out_writes_bytes_(WINHTTP_TIME_FORMAT_BUFSIZE) LPWSTR pwszTime // output string buffer ); BOOLAPI WinHttpTimeToSystemTime ( _In_z_ LPCWSTR pwszTime, // NULL terminated string _Out_ SYSTEMTIME *pst // output in GMT time ); BOOLAPI WinHttpCrackUrl ( _In_reads_(dwUrlLength) LPCWSTR pwszUrl, _In_ DWORD dwUrlLength, _In_ DWORD dwFlags, _Inout_ LPURL_COMPONENTS lpUrlComponents ); _Success_(return != FALSE) BOOLAPI WinHttpCreateUrl ( _In_ LPURL_COMPONENTS lpUrlComponents, _In_ DWORD dwFlags, _Out_writes_to_opt_(*pdwUrlLength, *pdwUrlLength) LPWSTR pwszUrl, _Inout_ LPDWORD pdwUrlLength ); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) */ #pragma endregion #pragma region Application Family or OneCore Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) BOOLAPI WinHttpCheckPlatform(void); WINHTTPAPI BOOL WINAPI WinHttpGetDefaultProxyConfiguration( IN OUT WINHTTP_PROXY_INFO * pProxyInfo); WINHTTPAPI BOOL WINAPI WinHttpSetDefaultProxyConfiguration( IN WINHTTP_PROXY_INFO * pProxyInfo); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */ #pragma endregion #pragma region Application Family or OneCore Family or Games Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) WINHTTPAPI HINTERNET WINAPI WinHttpOpen ( _In_opt_z_ LPCWSTR pszAgentW, _In_ DWORD dwAccessType, _In_opt_z_ LPCWSTR pszProxyW, _In_opt_z_ LPCWSTR pszProxyBypassW, _In_ DWORD dwFlags ); BOOLAPI WinHttpCloseHandle ( IN HINTERNET hInternet ); WINHTTPAPI HINTERNET WINAPI WinHttpConnect ( IN HINTERNET hSession, IN LPCWSTR pswzServerName, IN INTERNET_PORT nServerPort, IN DWORD dwReserved ); BOOLAPI WinHttpReadData ( IN HINTERNET hRequest, _Out_writes_bytes_to_(dwNumberOfBytesToRead, *lpdwNumberOfBytesRead) __out_data_source(NETWORK) LPVOID lpBuffer, IN DWORD dwNumberOfBytesToRead, OUT LPDWORD lpdwNumberOfBytesRead ); WINHTTPAPI DWORD WINAPI WinHttpReadDataEx ( IN HINTERNET hRequest, _Out_writes_bytes_to_(dwNumberOfBytesToRead, *lpdwNumberOfBytesRead) __out_data_source(NETWORK) LPVOID lpBuffer, IN DWORD dwNumberOfBytesToRead, OUT LPDWORD lpdwNumberOfBytesRead, IN ULONGLONG ullFlags, IN DWORD cbProperty, _In_reads_bytes_opt_(cbProperty) PVOID pvProperty ); BOOLAPI WinHttpWriteData ( IN HINTERNET hRequest, _In_reads_bytes_opt_(dwNumberOfBytesToWrite) LPCVOID lpBuffer, IN DWORD dwNumberOfBytesToWrite, OUT LPDWORD lpdwNumberOfBytesWritten ); BOOLAPI WinHttpQueryDataAvailable ( IN HINTERNET hRequest, __out_data_source(NETWORK) LPDWORD lpdwNumberOfBytesAvailable ); _Success_(return != FALSE) BOOLAPI WinHttpQueryOption ( IN HINTERNET hInternet, IN DWORD dwOption, _Out_writes_bytes_to_opt_(*lpdwBufferLength, *lpdwBufferLength) __out_data_source(NETWORK) LPVOID lpBuffer, IN OUT LPDWORD lpdwBufferLength ); BOOLAPI WinHttpSetOption( _In_opt_ HINTERNET hInternet, _In_ DWORD dwOption, _When_((dwOption == WINHTTP_OPTION_USERNAME || dwOption == WINHTTP_OPTION_PASSWORD || dwOption == WINHTTP_OPTION_PROXY_USERNAME || dwOption == WINHTTP_OPTION_PROXY_PASSWORD || dwOption == WINHTTP_OPTION_USER_AGENT), _At_((LPCWSTR)lpBuffer, _In_reads_(dwBufferLength))) _When_((dwOption == WINHTTP_OPTION_CLIENT_CERT_CONTEXT), _In_reads_bytes_opt_(dwBufferLength)) _When_((dwOption != WINHTTP_OPTION_USERNAME && dwOption != WINHTTP_OPTION_PASSWORD && dwOption != WINHTTP_OPTION_PROXY_USERNAME && dwOption != WINHTTP_OPTION_PROXY_PASSWORD && dwOption != WINHTTP_OPTION_CLIENT_CERT_CONTEXT && dwOption != WINHTTP_OPTION_USER_AGENT), _In_reads_bytes_(dwBufferLength)) LPVOID lpBuffer, _In_ DWORD dwBufferLength ); BOOLAPI WinHttpSetTimeouts ( IN HINTERNET hInternet, // Session/Request handle. IN int nResolveTimeout, IN int nConnectTimeout, IN int nSendTimeout, IN int nReceiveTimeout ); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) */ #pragma endregion #pragma region Application Family or OneCore Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) WINHTTPAPI DWORD WINAPI WinHttpIsHostInProxyBypassList ( _In_ const WINHTTP_PROXY_INFO *pProxyInfo, _In_z_ PCWSTR pwszHost, _In_ INTERNET_SCHEME tScheme, _In_ INTERNET_PORT nPort, _Out_ BOOL *pfIsInBypassList ); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */ #pragma endregion #pragma region Application Family or OneCore Family or Games Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) // // prototypes // WINHTTPAPI HINTERNET WINAPI WinHttpOpenRequest ( IN HINTERNET hConnect, IN LPCWSTR pwszVerb, IN LPCWSTR pwszObjectName, IN LPCWSTR pwszVersion, IN LPCWSTR pwszReferrer OPTIONAL, IN LPCWSTR FAR * ppwszAcceptTypes OPTIONAL, IN DWORD dwFlags ); BOOLAPI WinHttpAddRequestHeaders ( IN HINTERNET hRequest, _When_(dwHeadersLength == (DWORD)-1, _In_z_) _When_(dwHeadersLength != (DWORD)-1, _In_reads_(dwHeadersLength)) LPCWSTR lpszHeaders, IN DWORD dwHeadersLength, IN DWORD dwModifiers ); WINHTTPAPI DWORD WINAPI WinHttpAddRequestHeadersEx( IN HINTERNET hRequest, IN DWORD dwModifiers, IN ULONGLONG ullFlags, IN ULONGLONG ullExtra, IN DWORD cHeaders, _In_reads_(cHeaders) WINHTTP_EXTENDED_HEADER *pHeaders ); BOOLAPI WinHttpSendRequest ( IN HINTERNET hRequest, _In_reads_opt_(dwHeadersLength) LPCWSTR lpszHeaders, IN DWORD dwHeadersLength, _In_reads_bytes_opt_(dwOptionalLength) LPVOID lpOptional, IN DWORD dwOptionalLength, IN DWORD dwTotalLength, IN DWORD_PTR dwContext ); BOOLAPI WinHttpSetCredentials ( IN HINTERNET hRequest, // HINTERNET handle returned by WinHttpOpenRequest. IN DWORD AuthTargets, // Only WINHTTP_AUTH_TARGET_SERVER and // WINHTTP_AUTH_TARGET_PROXY are supported // in this version and they are mutually // exclusive IN DWORD AuthScheme, // must be one of the supported Auth Schemes // returned from WinHttpQueryAuthSchemes() IN LPCWSTR pwszUserName, // 1) NULL if default creds is to be used, in // which case pszPassword will be ignored IN LPCWSTR pwszPassword, // 1) "" == Blank Password; 2)Parameter ignored // if pszUserName is NULL; 3) Invalid to pass in // NULL if pszUserName is not NULL IN LPVOID pAuthParams ); BOOLAPI WinHttpQueryAuthSchemes ( IN HINTERNET hRequest, // HINTERNET handle returned by WinHttpOpenRequest OUT LPDWORD lpdwSupportedSchemes, // a bitmap of available Authentication Schemes OUT LPDWORD lpdwFirstScheme, // returns the first auth scheme returned by the server OUT LPDWORD pdwAuthTarget ); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) */ #pragma endregion #pragma region Application Family or OneCore Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) BOOLAPI WinHttpQueryAuthParams( IN HINTERNET hRequest, // HINTERNET handle returned by WinHttpOpenRequest IN DWORD AuthScheme, OUT LPVOID* pAuthParams // Scheme-specific Advanced auth parameters ); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */ #pragma endregion #pragma region Application Family or OneCore Family or Games Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) WINHTTPAPI BOOL WINAPI WinHttpReceiveResponse ( IN HINTERNET hRequest, IN LPVOID lpReserved ); _Success_(return != FALSE) BOOLAPI WinHttpQueryHeaders ( IN HINTERNET hRequest, IN DWORD dwInfoLevel, IN LPCWSTR pwszName OPTIONAL, _Out_writes_bytes_to_opt_(*lpdwBufferLength, *lpdwBufferLength) __out_data_source(NETWORK) LPVOID lpBuffer, IN OUT LPDWORD lpdwBufferLength, IN OUT LPDWORD lpdwIndex OPTIONAL ); WINHTTPAPI DWORD WINAPI WinHttpQueryHeadersEx ( _In_ HINTERNET hRequest, _In_ DWORD dwInfoLevel, _In_ ULONGLONG ullFlags, _In_ UINT uiCodePage, _Inout_opt_ PDWORD pdwIndex, _In_opt_ PWINHTTP_HEADER_NAME pHeaderName, _Out_writes_bytes_to_opt_(*pdwBufferLength, *pdwBufferLength) PVOID pBuffer, _Inout_ PDWORD pdwBufferLength, _Out_writes_opt_(*pdwHeadersCount) PWINHTTP_EXTENDED_HEADER *ppHeaders, _Out_ PDWORD pdwHeadersCount ); WINHTTPAPI DWORD WINAPI WinHttpQueryConnectionGroup ( _In_ HINTERNET hInternet, _In_opt_ const GUID *pGuidConnection, _In_ ULONGLONG ullFlags, _Inout_ PWINHTTP_QUERY_CONNECTION_GROUP_RESULT *ppResult ); WINHTTPAPI VOID WINAPI WinHttpFreeQueryConnectionGroupResult ( _Inout_ WINHTTP_QUERY_CONNECTION_GROUP_RESULT *pResult ); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) */ #pragma endregion #pragma region Application Family or OneCore Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) BOOLAPI WinHttpDetectAutoProxyConfigUrl ( DWORD dwAutoDetectFlags, _Outptr_result_maybenull_ LPWSTR * ppwstrAutoConfigUrl ); BOOLAPI WinHttpGetProxyForUrl ( IN HINTERNET hSession, IN LPCWSTR lpcwszUrl, IN WINHTTP_AUTOPROXY_OPTIONS * pAutoProxyOptions, OUT WINHTTP_PROXY_INFO * pProxyInfo ); WINHTTPAPI DWORD WINAPI WinHttpCreateProxyResolver ( _In_ HINTERNET hSession, _Out_ HINTERNET *phResolver ); WINHTTPAPI DWORD WINAPI WinHttpGetProxyForUrlEx ( _In_ HINTERNET hResolver, _In_ PCWSTR pcwszUrl, _In_ WINHTTP_AUTOPROXY_OPTIONS *pAutoProxyOptions, _In_opt_ DWORD_PTR pContext ); WINHTTPAPI DWORD WINAPI WinHttpGetProxyForUrlEx2 ( _In_ HINTERNET hResolver, _In_ PCWSTR pcwszUrl, _In_ WINHTTP_AUTOPROXY_OPTIONS *pAutoProxyOptions, _In_ DWORD cbInterfaceSelectionContext, _In_reads_bytes_opt_(cbInterfaceSelectionContext) BYTE *pInterfaceSelectionContext, _In_opt_ DWORD_PTR pContext ); WINHTTPAPI DWORD WINAPI WinHttpGetProxyResult ( _In_ HINTERNET hResolver, _Out_ WINHTTP_PROXY_RESULT *pProxyResult ); WINHTTPAPI DWORD WINAPI WinHttpGetProxyResultEx ( _In_ HINTERNET hResolver, _Out_ WINHTTP_PROXY_RESULT_EX *pProxyResultEx ); WINHTTPAPI VOID WINAPI WinHttpFreeProxyResult ( _Inout_ WINHTTP_PROXY_RESULT *pProxyResult ); WINHTTPAPI VOID WINAPI WinHttpFreeProxyResultEx ( _Inout_ WINHTTP_PROXY_RESULT_EX *pProxyResultEx ); WINHTTPAPI DWORD WINAPI WinHttpResetAutoProxy ( _In_ HINTERNET hSession, _In_ DWORD dwFlags ); BOOLAPI WinHttpGetIEProxyConfigForCurrentUser ( IN OUT WINHTTP_CURRENT_USER_IE_PROXY_CONFIG * pProxyConfig ); WINHTTPAPI DWORD WINAPI WinHttpWriteProxySettings( _In_ HINTERNET hSession, _In_ BOOL fForceUpdate, _In_ WINHTTP_PROXY_SETTINGS *pWinHttpProxySettings ); WINHTTPAPI DWORD WINAPI WinHttpReadProxySettings( _In_ HINTERNET hSession, _In_opt_ PCWSTR pcwszConnectionName, _In_ BOOL fFallBackToDefaultSettings, _In_ BOOL fSetAutoDiscoverForDefaultSettings, _Out_ DWORD *pdwSettingsVersion, _Out_ BOOL *pfDefaultSettingsAreReturned, _Out_ WINHTTP_PROXY_SETTINGS *pWinHttpProxySettings ); WINHTTPAPI VOID WINAPI WinHttpFreeProxySettings( _In_ WINHTTP_PROXY_SETTINGS *pWinHttpProxySettings ); WINHTTPAPI DWORD WINAPI WinHttpGetProxySettingsVersion( _In_ HINTERNET hSession, _Out_ DWORD *pdwProxySettingsVersion ); WINHTTPAPI DWORD WINAPI WinHttpSetProxySettingsPerUser( _In_ BOOL fProxySettingsPerUser ); #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */ #pragma endregion #pragma region Application Family or OneCore Family or Games Family #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) typedef enum _WINHTTP_WEB_SOCKET_OPERATION { WINHTTP_WEB_SOCKET_SEND_OPERATION = 0, WINHTTP_WEB_SOCKET_RECEIVE_OPERATION = 1, WINHTTP_WEB_SOCKET_CLOSE_OPERATION = 2, WINHTTP_WEB_SOCKET_SHUTDOWN_OPERATION = 3 } WINHTTP_WEB_SOCKET_OPERATION; typedef enum _WINHTTP_WEB_SOCKET_BUFFER_TYPE { WINHTTP_WEB_SOCKET_BINARY_MESSAGE_BUFFER_TYPE = 0, WINHTTP_WEB_SOCKET_BINARY_FRAGMENT_BUFFER_TYPE = 1, WINHTTP_WEB_SOCKET_UTF8_MESSAGE_BUFFER_TYPE = 2, WINHTTP_WEB_SOCKET_UTF8_FRAGMENT_BUFFER_TYPE = 3, WINHTTP_WEB_SOCKET_CLOSE_BUFFER_TYPE = 4 } WINHTTP_WEB_SOCKET_BUFFER_TYPE; typedef enum _WINHTTP_WEB_SOCKET_CLOSE_STATUS { WINHTTP_WEB_SOCKET_SUCCESS_CLOSE_STATUS = 1000, WINHTTP_WEB_SOCKET_ENDPOINT_TERMINATED_CLOSE_STATUS = 1001, WINHTTP_WEB_SOCKET_PROTOCOL_ERROR_CLOSE_STATUS = 1002, WINHTTP_WEB_SOCKET_INVALID_DATA_TYPE_CLOSE_STATUS = 1003, WINHTTP_WEB_SOCKET_EMPTY_CLOSE_STATUS = 1005, WINHTTP_WEB_SOCKET_ABORTED_CLOSE_STATUS = 1006, WINHTTP_WEB_SOCKET_INVALID_PAYLOAD_CLOSE_STATUS = 1007, WINHTTP_WEB_SOCKET_POLICY_VIOLATION_CLOSE_STATUS = 1008, WINHTTP_WEB_SOCKET_MESSAGE_TOO_BIG_CLOSE_STATUS = 1009, WINHTTP_WEB_SOCKET_UNSUPPORTED_EXTENSIONS_CLOSE_STATUS = 1010, WINHTTP_WEB_SOCKET_SERVER_ERROR_CLOSE_STATUS = 1011, WINHTTP_WEB_SOCKET_SECURE_HANDSHAKE_ERROR_CLOSE_STATUS = 1015 } WINHTTP_WEB_SOCKET_CLOSE_STATUS; typedef struct _WINHTTP_WEB_SOCKET_ASYNC_RESULT { WINHTTP_ASYNC_RESULT AsyncResult; WINHTTP_WEB_SOCKET_OPERATION Operation; } WINHTTP_WEB_SOCKET_ASYNC_RESULT; typedef struct _WINHTTP_WEB_SOCKET_STATUS { DWORD dwBytesTransferred; WINHTTP_WEB_SOCKET_BUFFER_TYPE eBufferType; } WINHTTP_WEB_SOCKET_STATUS; #define WINHTTP_WEB_SOCKET_MAX_CLOSE_REASON_LENGTH 123 #define WINHTTP_WEB_SOCKET_MIN_KEEPALIVE_VALUE 15000 WINHTTPAPI HINTERNET WINAPI WinHttpWebSocketCompleteUpgrade ( _In_ HINTERNET hRequest, _In_opt_ DWORD_PTR pContext ); WINHTTPAPI DWORD WINAPI WinHttpWebSocketSend ( _In_ HINTERNET hWebSocket, _In_ WINHTTP_WEB_SOCKET_BUFFER_TYPE eBufferType, _In_reads_opt_(dwBufferLength) PVOID pvBuffer, _In_ DWORD dwBufferLength ); WINHTTPAPI DWORD WINAPI WinHttpWebSocketReceive ( _In_ HINTERNET hWebSocket, _Out_writes_bytes_to_(dwBufferLength, *pdwBytesRead) PVOID pvBuffer, _In_ DWORD dwBufferLength, _Out_range_(0, dwBufferLength) DWORD *pdwBytesRead, _Out_ WINHTTP_WEB_SOCKET_BUFFER_TYPE *peBufferType ); WINHTTPAPI DWORD WINAPI WinHttpWebSocketShutdown ( _In_ HINTERNET hWebSocket, _In_ USHORT usStatus, _In_reads_bytes_opt_(dwReasonLength) PVOID pvReason, _In_range_(0, WINHTTP_WEB_SOCKET_MAX_CLOSE_REASON_LENGTH) DWORD dwReasonLength ); WINHTTPAPI DWORD WINAPI WinHttpWebSocketClose ( _In_ HINTERNET hWebSocket, _In_ USHORT usStatus, _In_reads_bytes_opt_(dwReasonLength) PVOID pvReason, _In_range_(0, WINHTTP_WEB_SOCKET_MAX_CLOSE_REASON_LENGTH) DWORD dwReasonLength ); WINHTTPAPI DWORD WINAPI WinHttpWebSocketQueryCloseStatus ( _In_ HINTERNET hWebSocket, _Out_ USHORT *pusStatus, _Out_writes_bytes_to_opt_(dwReasonLength, *pdwReasonLengthConsumed) PVOID pvReason, _In_range_(0, WINHTTP_WEB_SOCKET_MAX_CLOSE_REASON_LENGTH) DWORD dwReasonLength, _Out_range_(0, WINHTTP_WEB_SOCKET_MAX_CLOSE_REASON_LENGTH) DWORD *pdwReasonLengthConsumed ); #if defined(__cplusplus) } #endif /* * Return packing to whatever it was before we * entered this file */ #include <poppack.h> #endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM | WINAPI_PARTITION_GAMES) */ #pragma endregion #endif // !defined(_WINHTTPX_)
File: winhttp.h
Size: 76124
Date: Fri, 15 Jul 2022 21:00:12 +0200
Type: h
Size: 76124
Date: Fri, 15 Jul 2022 21:00:12 +0200
Type: h