Alternativflaggor

Följande alternativflaggor stöds av WinHttpQueryOption och WinHttpSetOption.

WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS

Standardvärdet är FALSE. Om värdet är TRUE garanterar WinHTTP inte förlopp om statusåteranrop blockeras av klientprogrammet.

Klientprogrammet måste vara särskilt noga med att utföra minimala åtgärder inom återanropet utan att blockera, returnera så snabbt som möjligt, och får i synnerhet inte vänta på några efterföljande WinHTTP-anrop. Om den inte följer dessa riktlinjer kommer det sannolikt att uppstå en negativ prestandapåverkan eller ett potentiellt program som hänger sig. Om det används på det föreskrivna sättet kan det här alternativet förbättra prestandan.

WINHTTP_OPTION_AUTOLOGON_POLICY

Anger ett osignerat långt heltalsvärde som anger principen för automatisk inloggning med något av följande värden.

Begrepp	Beskrivning
WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH	Standardautentiseringsuppgifter används inte. Observera att den här flaggan endast börjar gälla om du anger servern efter det faktiska datornamnet. Den börjar inte gälla om du anger servern efter "localhost" eller IP-adress.
WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW	En autentiserad inloggning med standardautentiseringsuppgifterna utförs för alla begäranden.
WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM	En autentiserad inloggning med standardautentiseringsuppgifterna utförs endast för begäranden på det lokala intranätet.

WINHTTP_OPTION_BACKGROUND_CONNECTIONS

När du ställer in det här alternativet på ett sessionshandtag måste du skicka det antal anslutningar som du vill öppna. När winhttp först skickar en begäran, i stället för att bara öppna en enda anslutning, öppnas ett antal anslutningar parallellt. Detta kan förbättra prestandan för efterföljande begäranden till samma mål, som inte har omkostnader för anslutningsetablering.

WINHTTP_OPTION_CALLBACK

Hämtar pekaren till motringningsfunktionen med WinHttpSetStatusCallback.

WINHTTP_OPTION_CLIENT_CERT_CONTEXT

Anger klientcertifikatkontexten. Om ett program tar emot ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED måste det anropa WinHttpSetOption för att ange ett certifikat innan begäran försöker igen. Som en del av bearbetningen av det här alternativet anropar WinHttp CertDuplicateCertificateContext i certifikatkontexten som anroparen tillhandahåller så att certifikatkontexten kan släppas oberoende av anroparen.

Anmärkning

Programmet bör inte försöka stänga certifikatarkivet med flaggan CERT_CLOSE_STORE_FORCE_FLAG i anropet till CertCloseStore i certifikatarkivet som certifikatkontexten hämtades från. En åtkomstöverträdelse kan inträffa.

När servern begär ett klientcertifikat returnerar WinHttpSendRequest eller WinHttpReceiveResponse ett ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED fel. Om servern begär certifikatet men inte kräver det kan programmet ange det här alternativet för att ange att det inte har något certifikat. Servern kan välja ett annat autentiseringsschema eller tillåta anonym åtkomst till servern. Programmet innehåller makrot WINHTTP_NO_CLIENT_CERT_CONTEXT i parametern lpBuffer för WinHttpSetOption enligt följande kodexempel.

BOOL fRet = WinHttpSetOption(hRequest,
                             WINHTTP_OPTION_CLIENT_CERT_CONTEXT,
                             WINHTTP_NO_CLIENT_CERT_CONTEXT,
                             0);

Om servern kräver ett klientcertifikat kan den skicka en 403 HTTP-statuskod som svar. Mer information finns i alternativet WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST .

WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST

Hämtar en SecPkgContext_IssuerListInfoEx struktur när felet från WinHttpSendRequest eller WinHttpReceiveResponseERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED. Utfärdarlistan i strukturen innehåller en lista över godtagbara certifikatutfärdare (CA) från servern. Klientprogrammet kan filtrera CA-listan för att hämta klientcertifikatet för SSL-autentisering.

Om servern begär klientcertifikatet, men inte kräver det, kan programmet anropa WinHttpSetOption med alternativet WINHTTP_OPTION_CLIENT_CERT_CONTEXT . Mer information finns i alternativet WINHTTP_OPTION_CLIENT_CERT_CONTEXT .

WINHTTP_OPTION_CODEPAGE

Anger den kodsida som används för att bearbeta URL:en (det vill: frågesträng). Standardvärdet är UTF8.

WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH

Anger ett osignerat långt heltalsvärde som anger om Passport-autentisering i WinHTTP-autentisering är aktiverat. Värdet kan vara något av följande:

Begrepp	Beskrivning
WINHTTP_DISABLE_PASSPORT_AUTH	Microsoft Passport-autentisering är inaktiverat. Det här är standardinställningen.
WINHTTP_DISABLE_PASSPORT_KEYRING	Passport-nyckelringen är inaktiverad. Det här är standardinställningen.
WINHTTP_ENABLE_PASSPORT_AUTH	Passport-autentisering är aktiverat.
WINHTTP_ENABLE_PASSPORT_KEYRING	Passport-nyckelringen är aktiverad.

WINHTTP_OPTION_CONNECT_RETRIES

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller antalet gångerWinHTTP försöker ansluta till en värd. Microsoft Windows HTTP Services (WinHTTP) försöker bara en gång per IP-adress (Internet Protocol). Om du till exempel försöker ansluta till en värd med flera anrop som har 10 IP-adresser och WINHTTP_OPTION_CONNECT_RETRIES är inställd på 7 försöker WinHTTP bara ansluta till de första sju IP-adresserna. Med samma uppsättning med 10 IP-adresser, om WINHTTP_OPTION_CONNECT_RETRIES har angetts till 20, försöker WinHTTP var och en av de 10 bara en gång. Om ett anslutningsförsök fortfarande misslyckas efter det angivna antalet försök, eller om tidsgränsen för anslutningen upphörde att gälla innan dess, avbryts begäran. Standardvärdet för WINHTTP_OPTION_CONNECT_RETRIES är fem försök.

WINHTTP_OPTION_CONNECT_TIMEOUT

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller timeout-värdet i millisekunder. Om du anger det här alternativet till oändligt (0xFFFFFFFF) inaktiveras den här timern.

Om en TCP-anslutningsbegäran tar längre tid än det här tidsgränsvärdet avbryts begäran. Standardtimeouten är 60 sekunder. När du försöker ansluta till flera IP-adresser för en enskild värd (en värd med flera värdar) är tidsgränsen för varje enskild anslutning.

WINHTTP_OPTION_CONNECTION_INFO

Hämtar källans och målets IP-adress och porten för begäran som genererade svaret när WinHttpReceiveResponse returnerar. Programmet anropar WinHttpQueryOption med alternativet WINHTTP_OPTION_CONNECTION_INFO och tillhandahåller WINHTTP_CONNECTION_INFO struktur i parametern lpBuffer . Mer information finns i WINHTTP_CONNECTION_INFO.

Gäller för: Windows XP med SP2 och senare; Windows 2003 med SP1 och senare.

WINHTTP_OPTION_CONNECTION_GUID

Markera anslutningen som är associerad med WinHTTP-begärandehandtaget med ett GUID. Detta ger anpassad kontroll över vilka begäranden som använder vilka grupper av anslutningar med alternativet WINHTTP_OPTION_MATCH_CONNECTION_GUID .

WINHTTP_OPTION_CONNECTION_STATS_V0

Retreives TCP_INFO_v0 struct för den underliggande anslutningen som används av begäran. Den returnerade structen kan innehålla statistik från tidigare begäranden som skickats via samma anslutning.

Anmärkning

Det här alternativet har ersatts av WINHTTP_OPTION_CONNECTION_STATS_V1.

WINHTTP_OPTION_CONNECTION_STATS_V1

Retreives TCP_INFO_v1 struct för den underliggande anslutningen som används av begäran. Den returnerade structen kan innehålla statistik från tidigare begäranden som skickats via samma anslutning.

WINHTTP_OPTION_CONTEXT_VALUE

Anger eller hämtar en DWORD_PTR som innehåller en pekare till kontextvärdet som är associerat med det här HINTERNET-handtaget . Värdet som lagras i bufferten används och flaggan WINHTTP_OPTION_CONTEXT_VALUE alternativ tilldelas ett nytt värde.

WINHTTP_OPTION_DECOMPRESSION

Anger ett DWORD med flaggor som avgör om WinHTTP automatiskt dekomprimerar svarskroppar med komprimerade Content-Encodings. WinHTTP kommer också att ange en lämplig Accept-Encoding rubrik, vilket åsidosättar alla som tillhandahålls av anroparen. Värden som stöds är:

Begrepp	Beskrivning
WINHTTP_DECOMPRESSION_FLAG_GZIP	Dekomprimera Content-Encoding: gzip-svar.
WINHTTP_DECOMPRESSION_FLAG_DEFLATE	Dekomprimera Content-Encoding: deflate responses.
WINHTTP_DECOMPRESSION_FLAG_ALL	Dekomprimera svar med innehåll-kodning som stöds.

Som standard levererar WinHTTP komprimerade svar till anroparen oförändrade.

WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING

Om du anger det här alternativet på en WinHttp-sessionsreferens kan du aktivera/inaktivera om servercertifikatkedjan har skapats.

WINHTTP_OPTION_DISABLE_FEATURE

Anger ett osignerat långt heltalsvärde som anger vilka funktioner som är inaktiverade med en eller flera av följande flaggor. Tänk på att den här funktionen endast ska skickas till WinHttpSetOption på begärandehandtag när begärandehandtaget har skapats med WinHttpOpenRequest och innan begäran skickas med WinHttpSendRequest.

Begrepp	Beskrivning
WINHTTP_DISABLE_AUTHENTICATION	Automatisk autentisering är inaktiverad.
WINHTTP_DISABLE_COOKIES	Automatisk tillägg av cookiehuvuden i begäranden inaktiveras. Dessutom läggs returnerade cookies inte automatiskt till i cookiedatabasen. Om du inaktiverar cookies kan det leda till dåliga prestanda för Passport-autentisering.
WINHTTP_DISABLE_KEEP_ALIVE	Inaktiverar keep-alive-semantik för anslutningen. Keep-alive-semantik krävs för MSN, NTLM och andra typer av autentisering.
WINHTTP_DISABLE_REDIRECTS	Automatisk omdirigering inaktiveras när begäranden skickas med WinHttpSendRequest. Om automatisk omdirigering har inaktiverats måste ett program registrera en återanropsfunktion för att Passport-autentiseringen ska lyckas.

WINHTTP_OPTION_DISABLE_GLOBAL_POOLING

Inaktiverar global pooldelning mellan sessioner. Detta rekommenderas eftersom global pooldelning mellan sessioner är ett äldre beteende som stöds som standard av kompatibilitetsskäl. Detta påverkas av att du senare ställer in maximalt antal anslutningar manuellt.

WINHTTP_OPTION_DISABLE_PROXY_AUTH_SCHEMES

Inaktiverar en eller flera av följande proxyautentiseringsmetoder i WinHTTP-sessionen genom att ange alla OR tillämpliga alternativ. Det här är alla scheman, förutom WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE, som tvingar användningen av det lokala datorkontot när begäranden skickas till en loopback eller lokal adress. Det förhindrar läckande systemautentiseringsuppgifter till lokala HTTP-proxyservrar.

Begrepp	Beskrivning
WINHTTP_PROXY_DISABLE_SCHEME_BASIC	Inaktiverar grundläggande autentiseringsschema.
WINHTTP_PROXY_DISABLE_SCHEME_DIGEST	Inaktiverar schemat för sammanfattad autentisering.
WINHTTP_PROXY_DISABLE_SCHEME_NTLM	Inaktiverar NTLM-autentiseringsschemat.
WINHTTP_PROXY_DISABLE_SCHEME_KERBEROS	Inaktiverar Kerberos-autentiseringsschemat.
WINHTTP_PROXY_DISABLE_SCHEME_NEGOTIATE	Inaktiverar negotiate-autentiseringsschemat.
WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE	Tvingar användningen av det lokala datorkontot när begäranden skickas till en loopback eller lokal adress.

WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK

Hindrar WinHTTP från att försöka ansluta igen med en lägre version av säkerhetsprotokollet när den inledande protokollförhandlingen misslyckas.

WINHTTP_OPTION_DISABLE_STREAM_QUEUE

Tillåter nya begäranden att öppna ytterligare en HTTP/2-anslutning när den maximala gränsen för samtidiga strömmar nås, i stället för att vänta på nästa tillgängliga ström på en befintlig anslutning.

WINHTTP_OPTION_ENABLE_FEATURE

Anger ett osignerat långt heltalsvärde som anger vilka funktioner som för närvarande är aktiverade. Kan vara något av följande värden.

Begrepp	Beskrivning
WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION	Om det är aktiverat återställer WinHTTP tillfälligt klientpersonifiering under hela SSL-certifikatautentiseringsåtgärderna. Det här värdet kan endast anges på sessionshandtaget.
WINHTTP_ENABLE_SSL_REVOCATION	Om det är aktiverat tillåter WinHTTP SSL-återkallelse. Det här värdet kan endast anges på begärandehandtaget.

WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL

Anger en DWORD-bitmask för godtagbara avancerade HTTP-versioner. Möjliga värden är:

Begrepp	Beskrivning
WINHTTP_PROTOCOL_FLAG_HTTP2 (0x1)	Aktiverar HTTP/2 för begäran.
WINHTTP_PROTOCOL_FLAG_HTTP3 (0x2)	Aktiverar HTTP/3 för begäran.
Ingen (0x0)	Begränsar begäran till HTTP/1.1 och tidigare.

Äldre versioner av HTTP (1.1 och tidigare) kan inte inaktiveras med det här alternativet. Standardvärdet är 0x0.

WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT

Det här alternativet kan ställas in på en WinHttp-sessionsreferens så att WinHttp kan använda klientcertifikatkontexten som tillhandahålls av anroparen när HTTP/2 används.

WINHTTP_OPTION_ENABLETRACING

Anger ett BOOL-värde som anger om spårning är aktiverat för närvarande. Det här alternativet kan endast anges på en NULLHINTERNET-handtag . Se även Samla in WinHTTP-spårningar.

WINHTTP_OPTION_ENCODE_EXTRA

Aktiverar URL-procentkodning för sökväg och frågesträng.

Du kan också procentkoda innan du anropar WinHttp.

WINHTTP_OPTION_EXPIRE_CONNECTION

Det här alternativet kan bara anges på en begärandereferens som fortfarande är aktiv (skickar eller tar emot). Om du anger det här alternativet uppmanas WinHttp att sluta betjäna begäranden på den anslutning som är associerad med begärandehandtaget som skickas. Anslutningen stängs när begärandehandtaget som det här alternativet anropas med har slutförts. Det här alternativet tar inga parametrar.

WINHTTP_OPTION_EXTENDED_ERROR

Hämtar ett osignerat långt heltalsvärde som innehåller en Microsoft Windows Sockets-felkod som mappades till felmeddelandena ERROR_WINHTTP_* som senast returnerades i den här trådkontexten. Du kan skicka NULL som referensvärde.

WINHTTP_OPTION_FEATURE_SUPPORTED

Kontrollera om en angiven alternativflagga stöds av den här versionen av WinHTTP.

WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION

När WinHttp skickar en begäran som standard, om det inte finns några tillgängliga anslutningar för att hantera begäran, försöker WinHttp upprätta en ny anslutning och begäran kommer att vara bunden till den nya anslutningen. När du anger det här alternativet kommer en sådan begäran i stället att hanteras på den första anslutningen som blir tillgänglig, och inte nödvändigtvis den som upprättas.

WINHTTP_OPTION_GLOBAL_PROXY_CREDS

Tar en pekare till en WINHTTP_CREDS_EX struktur med funktionsparametern hInternet inställd på NULL. Det här alternativet kräver registernyckeln HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Om registernyckeln inte har angetts returnerar WinHTTP fel ERROR_WINHTTP_INVALID_OPTION. Den här registernyckeln finns inte som standard. När den har angetts skickar WinINet autentiseringsuppgifterna till WinHTTP. När WinHttp får en autentiseringsutmaning och om det inte finns några autentiseringsuppgifter inställda på det aktuella handtaget använder den de autentiseringsuppgifter som tillhandahålls av WinINet. För att kunna dela serverautentiseringsuppgifter utöver proxyautentiseringsuppgifter måste användarna ange WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

WINHTTP_OPTION_GLOBAL_SERVER_CREDS

Tar en pekare till en WINHTTP_CREDS_EX struktur med funktionsparametern hInternet inställd på NULL. Det här alternativet kräver registernyckeln HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Om registernyckeln inte har angetts returnerar WinHTTP fel ERROR_WINHTTP_INVALID_OPTION. Den här registernyckeln finns inte som standard. När den har angetts skickar WinINet autentiseringsuppgifterna till WinHTTP. När WinHttp får en autentiseringsutmaning och om det inte finns några autentiseringsuppgifter inställda på det aktuella handtaget använder den de autentiseringsuppgifter som tillhandahålls av WinINet. För att kunna dela serverautentiseringsuppgifter utöver proxyautentiseringsuppgifter måste användarna ange WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

WINHTTP_OPTION_HANDLE_TYPE

Hämtar ett osignerat långt heltalsvärde som innehåller den typ av HINTERNET-referens som skickades in. Returvärdet kan vara något av följande:

Begrepp	Beskrivning
WINHTTP_HANDLE_TYPE_CONNECT	Handtaget är ett anslutningshandtag.
WINHTTP_HANDLE_TYPE_REQUEST	Handtaget är en begärandereferens.
WINHTTP_HANDLE_TYPE_SESSION	Handtaget är ett sessionshandtag.

WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED

Förhindrar att andra protokollversioner än de som aktiveras av WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL används för begäran.

WINHTTP_OPTION_HTTP_PROTOCOL_USED

Hämtar ett DWORD som anger vilken avancerad HTTP-version som användes på en viss begäran. En lista över möjliga värden finns i WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL.

WINHTTP_OPTION_HTTP_VERSION

Anger eller hämtar en HTTP_VERSION_INFO struktur som deklarerar den äldre HTTP-version som stöds. Det här är ett processomfattande alternativ. använd NULL för handtaget.

Anmärkning

Den här strukturen är giltig för HTTP/1.0 och HTTP/1.1. Moderna HTTP-versioner finns i WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL och WINHTTP_OPTION_HTTP_PROTOCOL_USED.

WINHTTP_OPTION_HTTP2_KEEPALIVE

Det här alternativet kan ställas in på ett sessionshandtag så att WinHttp använder HTTP/2 PING-ramar som en keepalive-mekanism. Anropare anger en tidsgräns i millisekunder, och när det inte finns någon aktivitet på en anslutning för den tidsgränsperioden börjar WinHttp skicka HTTP/2 PING-ramar. Anropare kan inte ange ett timeoutvärde som är mindre än 5 000 millisekunder.

WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING

Det här alternativet kan ställas in på en WinHttp-begärandereferens för att styra hur WinHttp beter sig när ett HTTP/2-svar innehåller ett "Transfer-Encoding"-huvud. I så fall returnerar WinHttp ett fel om det här alternativet är inställt på FALSE.

WINHTTP_OPTION_HTTP2_RECEIVE_WINDOW

Ange den första HTTP/2-strömmens mottagningsfönsterstorlek och tröskelvärdet för att skicka fönsteruppdateringar med hjälp av WINHTTP_HTTP2_RECEIVE_WINDOW struct.

WINHTTP_OPTION_HTTP3_HANDSHAKE_TIMEOUT

Använder bufferten för att ange tidsgränsen för HTTP/3-handskakning i millisekunder som ett PDWORD.

WINHTTP_OPTION_HTTP3_INITIAL_RTT

Konfigurerar den första RTT i millisekunder som används av msquic.

WINHTTP_OPTION_HTTP3_KEEPALIVE

Aktiverar keep-alive-semantik för anslutningen. Använder bufferten för att ange timeouten keep-alive i millisekunder som ett PDWORD.

WINHTTP_OPTION_HTTP3_STREAM_ERROR_CODE

Hämtar det server-angivna felet på HTTP/3-strömmen som används för att skicka begäran.

WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE

Tillåter att säkra anslutningar använder säkerhetscertifikat för vilka listan över återkallade certifikat inte kunde laddas ned.

WINHTTP_OPTION_IPV6_FAST_FALLBACK

Aktiverar snabb återställning av IPv6 (Happier Eyeballs) för anslutningen. Det här beteendet liknar happy eyeballs-beteendet som beskrivs i RFC 6555 för att förbättra anslutningstiderna i nätverk där IPv6 är opålitligt.

• Om både IPv6- och IPv4-adresser löses för en viss värd börjar WinHttp med att ansluta till den första lösta IPv6-adressen med en kort tidsgräns på 300 ms.
• Om anslutningen misslyckas försöker WinHttp ansluta till den första lösta IPv4-adressen med standardtimeouten.
• Om den andra anslutningen misslyckas försöker WinHttp igen med den första lösta IPv6-adressen med standardtimeouten.
• Om den tredje anslutningen misslyckas återgår WinHttp till standardbeteendet för eventuella återstående adresser, försöker ansluta till var och en med standardtimeouten tills en anslutning har upprättats eller inga adresser finns kvar.

WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE

Hämtar om ett proxyreturanslutningssvar kan hämtas eller inte.

WINHTTP_OPTION_MATCH_CONNECTION_GUID

Tar en WINHTTP_MATCH_CONNECTION_GUID struct för att be WinHTTP att hantera begäran om en matchande anslutning. Om WINHTTP_MATCH_CONNECTION_GUID_FLAG_REQUIRED anges kan endast anslutningar med matchande GUID användas. Annars kan anslutningar med matchande GUID och anslutningar som inte har markerats med något GUID användas.

WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller det maximala antalet anslutningar som tillåts per HTTP/1.0-server. Standardvärdet är INFINITE.

Gäller för: Windows Vista med SP1 och senare; Windows Server 2008 och senare.

WINHTTP_OPTION_MAX_CONNS_PER_SERVER

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller det maximala antalet anslutningar som tillåts per server. Standardvärdet är INFINITE.

När det här alternativet är inställt på noll anger WinHTTP gränsen för antalet anslutningar till 2.

WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS

Anger det maximala antalet omdirigeringar som WinHTTP följer. standardvärdet är 10. Den här gränsen förhindrar att obehöriga webbplatser pausar WinHTTP-klienten efter ett stort antal omdirigeringar.

Gäller för: Windows XP med SP1 och senare; Windows 2000 med SP3 och senare.

WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE

Det maximala antalet statuskodsvar för Informational 100-199 ignoreras innan den slutliga statuskoden returneras till WinHTTP-klienten. Informationsstatuskoderna 100–199 kan skickas av servern före den slutliga statuskoden och beskrivs i specifikationen för HTTP/1.1 (mer information finns i RFC 2616). Standardvärdet är 10.

Gäller för: Windows XP med SP1 och senare; Windows 2000 med SP3 och senare.

WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE

En gräns för mängden data som tömts från svar för att återanvända en anslutning, som anges i byte. Standardvärdet är 1 MB.

Gäller för: Windows XP med SP1 och senare; Windows 2000 med SP3 och senare.

WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE

En bunden uppsättning på den maximala storleken på huvuddelen av serversvaret, som anges i byte. Den här bindningen skyddar klienten från en obehörig server som försöker stoppa klienten genom att skicka ett svar med en oändlig mängd huvuddata. Standardvärdet är 64 KB.

Gäller för: Windows XP med SP1 och senare; Windows 2000 med SP3 och senare.

WINHTTP_OPTION_PARENT_HANDLE

Hämtar det överordnade handtaget till det här handtaget.

WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT

Hämtar en sträng som innehåller den cobranding-text som tillhandahålls av Passport-inloggningsservern. Det här alternativet ska hämtas omedelbart efter att inloggningsservern svarar med statuskoden 401. Ett program bör skicka in en buffertstorlek, i byte, som är tillräckligt stor för att innehålla den returnerade strängen.

WINHTTP_OPTION_PASSPORT_COBRANDING_URL

Hämtar en sträng som innehåller en URL för en cobranding-grafik som tillhandahålls av Passport-inloggningsservern. Det här alternativet ska hämtas omedelbart efter att inloggningsservern svarar med statuskoden 401. Ett program bör skicka in en buffertstorlek, i byte, som är tillräckligt stor för att innehålla den returnerade strängen.

WINHTTP_OPTION_PASSPORT_RETURN_URL

Anger ett skrivskyddat alternativ på en begärandereferens som hämtar Passport-retur-URL:en.

WINHTTP_OPTION_PASSPORT_SIGN_OUT

Anger alternativet på ett sessionshandtag för att logga ut från alla Passport-inloggningar. Ett program ska skicka in den Passport-retur-URL som hämtades med WINHTTP_OPTION_PASSPORT_RETURN_URL. Alla cookies som är relaterade till retur-URL:en rensas.

WINHTTP_OPTION_PASSWORD

Anger eller hämtar ett strängvärde som innehåller lösenordet som är associerat med en begärandereferens.

WINHTTP_OPTION_PROXY

Anger eller hämtar en WINHTTP_PROXY_INFO struktur som innehåller proxydata på en befintlig sessionsreferens eller begärandehandtag. När du hämtar proxydata måste ett program frigöra lpszProxy - och lpszProxyBypass-strängarna i den här strukturen (om de inte är NULL) med hjälp av funktionen GlobalFree . Ett program kan fråga efter globala proxydata (standardproxyn) genom att skicka ett NULL-handtag .

WINHTTP_OPTION_PROXY_PASSWORD

Anger eller hämtar ett strängvärde som innehåller lösenordet som används för att komma åt proxyn.

WINHTTP_OPTION_PROXY_SPN_USED

Hämtar proxyserverns huvudnamn som WinHTTP angav till SSPI under autentiseringen. Det här strängvärdet används för att skicka till SspiPromptForCredentials efter ett autentiseringsfel .

WINHTTP_OPTION_PROXY_USERNAME

Anger eller hämtar ett strängvärde som innehåller användarnamnet som används för att komma åt proxyn.

WINHTTP_OPTION_QUIC_STATS

Hämtar en QUIC_STATISTICS struktur som innehåller anslutningsinformation som RTT och byte som skickas och tas emot.

WINHTTP_OPTION_READ_BUFFER_SIZE

Det här alternativet är inaktuellt. det har ingen effekt.

WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE

Anger om proxysvarentiteten kan hämtas eller inte. Det här alternativet är inaktiverat som standard.

WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller timeout-värdet, i millisekunder, för att vänta tills alla svarshuvuden till en begäran visas. Om WinHTTP inte kan ta emot alla rubriker inom den här tidsgränsen avbryts begäran. Standardvärdet för timeout är 90 sekunder.

Den här tidsgränsen kontrolleras endast när data tas emot från socketen. När tidsgränsen går ut meddelas därför inte klientprogrammet förrän mer data kommer från servern. Om inga data kommer från servern kan fördröjningen mellan tidsgränsen för förfallotiden och meddelandet för klientprogrammet vara lika stor som timeout-värdet som anges med hjälp av parametern dwReceiveTimeout för funktionen WinHttpSetTimeouts .

WINHTTP_OPTION_RECEIVE_TIMEOUT

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller timeout-värdet, i millisekunder, för att ta emot ett partiellt svar på en begäran eller läsa vissa data. Om svaret tar längre tid än det här tidsgränsvärdet avbryts begäran. Standardvärdet för timeout är 30 sekunder.

WINHTTP_OPTION_REDIRECT_POLICY

Anger beteendet för WinHTTP när det gäller hanteringen av en 30x HTTP-omdirigeringsstatuskod. Det här alternativet kan ställas in på en session eller begärandereferens till något av följande värden:

Begrepp	Beskrivning
WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS	Alla omdirigeringar följs automatiskt.
WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP	Alla omdirigeringar följs, förutom de som kommer från en säker URL (https) till en osäker (http) URL. Det här är standardinställningen.
WINHTTP_OPTION_REDIRECT_POLICY_NEVER	Omdirigeringar följs aldrig. 30x-statusen returneras till programmet.

WINHTTP_OPTION_REJECT_USERPWD_IN_URL

Avvisar URL:er som innehåller ett användarnamn och lösenord. Det här alternativet avvisar också URL:er som innehåller användarnamn: lösenordssemantik, även om inget användarnamn eller lösenord har angetts. Till exempel flaggas "u:p@hostname", ":@hostname", "u:@hostname" och ":p@hostname" som ogiltiga. Om en ogiltig URL skickas till funktionen returneras ERROR_WINHTTP_INVALID_URL. Det här alternativet är inaktiverat som standard.

WINHTTP_OPTION_REQUEST_ANNOTATION

Gör det möjligt att hämta och ange en begärandeanteckning för det angivna anteckningsnamnet. Det gör att anroparen kan koppla en sträng till begäran om senare hämtning för att identifiera begäranden med den anpassade logik som anroparen finner användbar.

WINHTTP_OPTION_REQUEST_PRIORITY

Det här alternativet är inaktuellt. det har ingen effekt.

WINHTTP_OPTION_REQUEST_STATS

Retreives-statistik för begäran. En lista över tillgänglig statistik finns i WINHTTP_REQUEST_STATS.

WINHTTP_OPTION_REQUEST_TIMES

Retreives timing information för begäran. En lista över tillgängliga tidsinställningar finns i WINHTTP_REQUEST_TIMES.

WINHTTP_OPTION_REQUIRE_STREAM_END

Det här alternativet uppmanar WinHttp att ignorera "Innehållslängd"-svarshuvuden och fortsätta att ta emot på en dataström tills flaggan END_STREAM tas emot.

WINHTTP_OPTION_RESOLUTION_HOSTNAME

Det här alternativet kan ställas in på en WinHttp-begärandehandtag innan det har skickats. Om det anges använder WinHttp den nummerpresentationssträng som värdnamn för DNS-matchning.

WINHTTP_OPTION_RESOLVE_TIMEOUT

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller tidsgränsvärdet i millisekunder för att matcha ett värdnamn. Standardvärdet för timeout är INFINITE. Om ett värde som inte är standard har angetts, finns det ett omkostnader för en trådskapande per namnmatchning.

WINHTTP_OPTION_REVERT_IMPERSONATION_SERVER_CERT

Återställer alla trådpersonifieringar när du skapar servercertifikatkedjan, vilket tvingar användning av processtoken i stället.

WINHTTP_OPTION_SECURE_PROTOCOLS

Anger ett osignerat långt heltalsvärde som anger vilka säkra protokoll (HTTPS) som är acceptabla. Standardvärdet för den här inställningen varierar beroende på operativsystemversion och kan påverkas av installerade uppdateringar.

• Windows 11. Som standard är endast TLS1.2 och TLS1.3 aktiverade.
• Windows 10 och Windows 8.1. Som standard är endast SSL3, TLS1.0, TLS1.1 och TLS1.2 aktiverade.
• Windows 8 och Windows 7. Som standard är endast SSL3 och TLS1 aktiverade.

Värdet kan vara en kombination av ett eller flera av följande värden.

Begrepp	Beskrivning
WINHTTP_FLAG_SECURE_PROTOCOL_ALL	Protokollen Secure Sockets Layer (SSL) 2.0, SSL 3.0 och TLS (Transport Layer Security) 1.0 kan användas.
WINHTTP_FLAG_SECURE_PROTOCOL_SSL2	SSL 2.0-protokollet kan användas.
WINHTTP_FLAG_SECURE_PROTOCOL_SSL3	SSL 3.0-protokollet kan användas.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1	TLS 1.0-protokollet kan användas.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_1	TLS 1.1-protokollet kan användas.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_2	TLS 1.2-protokollet kan användas.
WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_3	TLS 1.3-protokollet kan användas.

Om du behöver aktivera stöd för nyare protokoll men inte kan kompilera om programmet för att använda lämpliga värden för WINHTTP_OPTION_SECURE_PROTOCOLS kan du i stället lägga till DefaultSecureProtocols registerposten. Med registerposten kan du ange vilka säkra protokoll som ska användas när alternativet WINHTTP_OPTION_SECURE_PROTOCOLS inte har angetts.

Viktigt!

Anvisningarna nedan omfattar ändring av registret. Allvarliga problem kan dock uppstå om du ändrar registret felaktigt. Se därför till att du följer dessa instruktioner noggrant. Säkerhetskopiera registret innan du ändrar det för extra skydd. Sedan kan du återställa registret om ett problem uppstår. Mer information om hur du säkerhetskopierar och återställer registret finns i Säkerhetskopiera och återställa registret i Windows.

Om ett program inte anropar WinHttpSetOption(WINHTTP_OPTION_SECURE_PROTOCOLS) söker DefaultSecureProtocols systemet efter registerposten och åsidosätter, om det finns den, det befintliga operativsystemets standardvärden med de protokoll som anges i DefaultSecureProtocols registerposten. De WinHTTP-angivna protokollen kan åsidosättas av konfigurationsinställningar för säker kanal (Schannel) som kan inaktivera protokoll.

Du kan lägga till DefaultSecureProtocols registerposten i följande sökväg:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp

På x64-baserade datorer måste du också lägga till DefaultSecureProtocols i Wow6432Node sökvägen:

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp

Registervärdet är en DWORD-bitmapp. Värdet som ska användas bestäms genom att de värden som motsvarar de önskade protokollen läggs till.

DefaultSecureProtocols-värde	Protokoll aktiverat
0x00000008	Aktivera SSL 2.0 som standard
0x00000020	Aktivera SSL 3.0 som standard
0x00000080	Aktivera TLS 1.0 som standard
0x00000200	Aktivera TLS 1.1 som standard
0x00000800	Aktivera TLS 1.2 som standard
0x00002000	Aktivera TLS 1.3 som standard

Om du till exempel vill åsidosätta standardvärdena för WINHTTP_OPTION_SECURE_PROTOCOLS för att ange TLS 1.1 och TLS 1.2. I så fall tar du värdet för TLS 1.1 (0x00000200) och värdet för TLS 1.2 (0x00000800), lägger ihop dem i kalkylatorn (i programmerarläge) och det resulterande registervärdet blir 0x00000A00.

WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT

Hämtar certifikatet för en SSL/TLS-server till WINHTTP_CERTIFICATE_INFO struktur. Programmet måste frigöra lpszSubjectInfo - och lpszIssuerInfo-medlemmar med LocalFree.

WINHTTP_OPTION_SECURITY_FLAGS

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller säkerhetsflaggor för ett handtag. Det kan vara en kombination av följande värden:

Begrepp	Beskrivning
SECURITY_FLAG_IGNORE_CERT_CN_INVALID	Tillåter ett ogiltigt gemensamt namn i ett certifikat. Det innebär att servernamnet som anges av programmet inte matchar det gemensamma namnet i certifikatet. Om den här flaggan har angetts får programmet inte något WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID återanrop.
SECURITY_FLAG_IGNORE_CERT_DATE_INVALID	Tillåter ett ogiltigt certifikatdatum, dvs. ett utgånget eller ännu inte effektivt certifikat. Om den här flaggan har angetts får programmet inte något WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID återanrop.
SECURITY_FLAG_IGNORE_UNKNOWN_CA	Tillåter en ogiltig certifikatutfärdare. Om den här flaggan har angetts får programmet inte något WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA återanrop.
SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE	Tillåter att en servers identitet upprättas med ett certifikat som inte är server (till exempel ett klientcertifikat).
SECURITY_FLAG_IGNORE_WEAK_SIGNATURE	Tillåter att en svag signatur ignoreras. Den här flaggan är tillgänglig i sammanslagningsuppdateringen för varje operativsystem som börjar med Windows 7 och Windows Server 2008 R2.
SECURITY_FLAG_SECURE	Använder säkra överföringar. Detta returneras endast i ett anrop till WinHttpQueryOption.
SECURITY_FLAG_STRENGTH_MEDIUM	Använder medelhög (56-bitars) kryptering. Detta returneras endast i ett anrop till WinHttpQueryOption.
SECURITY_FLAG_STRENGTH_STRONG	Använder stark (128-bitars) kryptering. Detta returneras endast i ett anrop till WinHttpQueryOption.
SECURITY_FLAG_STRENGTH_WEAK	Använder svag (40-bitars) kryptering. Detta returneras endast i ett anrop till WinHttpQueryOption.

WINHTTP_OPTION_SECURITY_INFO

Retreives SChannel-anslutningen och chifferinformationen för en begäran.

WINHTTP_OPTION_SECURITY_KEY_BITNESS

Hämtar ett osignerat långt heltalsvärde som innehåller krypteringsnyckelns chifferstyrka. Ett större tal indikerar starkare kryptering av chifferstyrka.

WINHTTP_OPTION_SEND_TIMEOUT

Anger eller hämtar ett osignerat långt heltalsvärde som innehåller timeout-värdet i millisekunder för att skicka en begäran eller skriva data. Om det tar längre tid än tidsgränsen att skicka begäran avbryts sändningsåtgärden. Standardtimeouten är 30 sekunder.

WINHTTP_OPTION_SERVER_CBT

Hämtar en pekare till SecPkgContext_Bindings struktur som anger en kanalbindningstoken (CBT).

En kanalbindningstoken är en egenskap för en säker transportkanal och används för att binda en autentiseringskanal till den säkra transportkanalen. Den här token kan bara hämtas med det här alternativet när en SSL-anslutning har upprättats.

Anmärkning

Om du skickar det här alternativet och ett null-värde för lpBuffer till WinHttpQueryOption returneras ERROR_INSUFFICIENT_BUFFER och den nödvändiga bytestorleken för bufferten i parametern lpdwBufferLength . Det returnerade buffertstorleksvärdet kan skickas i ett efterföljande anrop för att fråga efter kanalbindningstoken. De här stegen är nödvändiga när du hanterar WINHTTP_CALLBACK_STATUS_REQUEST om du vill ändra begärandehuvuden baserat på kanalbindningstoken. Observera att Windows XP och Vista inte stöder ändring av begärandehuvuden under det här återanropet.

WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT

Hämtar kontexten för servercertifieringskedjan. WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT kan skickas för att hämta en duplicerad pekare till CERT_CHAIN_CONTEXT för en servercertifikatkedja som togs emot under en förhandlad SSL-anslutning. Klienten måste anropa CertFreeCertificateContext på den returnerade PCCERT_CONTEXT pekaren som är ifylld i bufferten.

WINHTTP_OPTION_SERVER_CERT_CONTEXT

Hämtar servercertifieringskontexten. WINHTTP_OPTION_SERVER_CERT_CONTEXT kan skickas för att hämta en duplicerad pekare till CERT CONTEXT för ett servercertifikat som togs emot under en förhandlad SSL-anslutning. Klienten måste anropa CertFreeCertificateContext på den returnerade PCCERT_CONTEXT pekaren som är ifylld i bufferten.

WINHTTP_OPTION_SERVER_SPN_USED

Hämtar serverserverns huvudnamn som WinHTTP angav till SSPI under autentiseringen. Det här strängvärdet kan skickas till SspiPromptForCredentials efter ett autentiseringsfel .

WINHTTP_OPTION_SPN

Inkluderar eller tar bort serverportnumret när SPN (tjänstens huvudnamn) skapas för Kerberos- eller Negotiate Kerberos-autentisering. Den här flaggan är ett av följande värden:

Begrepp	Beskrivning
WINHTTP_DISABLE_SPN_SERVER_PORT	Tar bort serverportnumret.
WINHTTP_ENABLE_SPN_SERVER_PORT	Innehåller serverportnumret.

WINHTTP_OPTION_STREAM_ERROR_CODE

Det här alternativet kan frågas på en WinHttp-begärandereferens och returnerar felkoden som anges av en RST_STREAM bildruta som tagits emot på en HTTP-ström.

WINHTTP_OPTION_TCP_FAST_OPEN

Aktiverar TCP Fast Open för anslutningen.

WINHTTP_OPTION_TCP_KEEPALIVE

Det här alternativet kan ställas in på en WinHttp-sessionsreferens för att aktivera TCP keep-alive-beteende på den underliggande socketen. Tar en tcp_keepalive struct.

WINHTTP_OPTION_TLS_FALSE_START

Aktiverar TLS False Start för anslutningen.

WINHTTP_OPTION_TCP_PRIORITY_STATUS

Fråga den antydda prioriteten för TCP-socketuppsättningen med WINHTTP_OPTION_TCP_PRIORITY_HINT. Mer information finns i dokumentationen för SIO_SET_PRIORITY_HINT .

WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK

Det här alternativet kan ställas in på en WinHttp-sessionsreferens för att styra om återställning till TLS 1.0 tillåts om det uppstår ett TLS-handskakningsfel med en nyare protokollversion.

WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT

Tar en händelse som kommer att anges när det senaste återanropet har slutförts för en viss session. Den här flaggan måste användas på ett sessionshandtag. Händelsen kan inte stängas förrän den har angetts av WinHTTP.

WINHTTP_OPTION_UNSAFE_HEADER_PARSING

Det här alternativet är reserverat för internt bruk och bör inte anropas.

WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET

Instruerar stacken att starta en WebSocket-handskakningsprocess med WinHttpSendRequest. Det här alternativet tar inga parametrar.

WINHTTP_OPTION_URL

Hämtar ett strängvärde som innehåller den fullständiga URL:en för en nedladdad resurs. Om den ursprungliga URL:en innehöll några extra data, till exempel söksträngar eller fästpunkter, eller om anropet omdirigerades, skiljer sig url:en som returnerades från originalet. Programmet ska skicka in en buffert, storleksanpassad i byte, som är tillräckligt stor för att lagra den returnerade URL:en i brett tecken.

WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS

Tar en BOOL och kan bara ställas in ett sessionshandtag. Den sprids endast ned till referenser som skapats från sessionshandtaget när alternativet har angetts. Om det är SANT orsakar det här alternativet som en sista utväg användningen av globala serverautentiseringsuppgifter som har push-överförts från WinInet. Standardvärdet för det här alternativet är FALSE. Det här alternativet kräver registernyckeln HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Den här registernyckeln finns inte som standard. När den har angetts skickar WinINet autentiseringsuppgifterna till WinHTTP. När WinHttp får en autentiseringsutmaning och om det inte finns några autentiseringsuppgifter inställda på det aktuella handtaget använder den de autentiseringsuppgifter som tillhandahålls av WinINet.

WINHTTP_OPTION_USE_SESSION_SCH_CRED

Tillåter att en enskild autentiseringsuppgift används som standard för alla slutpunkter i sessionen i stället för att ha standardautentiseringsuppgifter per slutpunkt. Det kan förbättra prestanda genom att minska kostnaderna för hantering av autentiseringsuppgifter. Observera att den här standardautentiseringsuppgiften inte har någon effekt när ett klientcertifikat uttryckligen tillhandahålls.

WINHTTP_OPTION_USER_AGENT

Anger eller hämtar användaragentsträngen på referenser som tillhandahålls av WinHttpOpen och används i efterföljande WinHttpSendRequest-funktioner , så länge den inte åsidosätts av en rubrik som lagts till av WinHttpAddRequestHeaders eller WinHttpSendRequest. När du hämtar en användaragent bör programmet skicka in en buffert, storleksanpassad i byte, som är tillräckligt stor för att lagra den returnerade URL:en i brett tecken. När du anger användaragenten är buffertstorleken längden på strängen, i tecken plus NULL-avslut .

WINHTTP_OPTION_USERNAME

Anger eller hämtar en sträng som innehåller användarnamnet.

WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT

Anger den tid i millisekunder som WinHttpWebSocketClose ska vänta för att slutföra det nära handskakningen. Standardvärdet är 10 sekunder.

WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL

Anger intervallet i millisekunder för att skicka ett keep-alive-paket över anslutningen. Standardintervallet är 30 000 (30 sekunder). Det minsta intervallet är 15 000 (15 sekunder). Om du använder WinHttpSetOption för att ange ett värde som är lägre än 15000 returneras med ERROR_INVALID_PARAMETER.

Anmärkning

Standardvärdet för WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL läse från HKLM:\SOFTWARE\Microsoft\WebSocket\KeepaliveInterval. Om ett värde inte anges används standardvärdet 30000. Det går inte att ha ett lägre keepalive-intervall än 15 000 millisekunder.

WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE

Anger eller hämtar ett DWORD som anger den mottagningsbuffertstorlek som ska användas på WebSocket-anslutningar.

WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE

Anger eller hämtar ett DWORD som anger den buffertstorlek som ska användas på WebSocket-anslutningar.

WINHTTP_OPTION_WORKER_THREAD_COUNT

Anger ett osignerat långt heltalsvärde som anger antalet arbetstrådar som trådpoolen ska använda för asynkrona slutföranden. Standardvärdet för det här alternativet är noll, vilket anger att antalet arbetstrådar är lika med antalet processorer i systemet. Det här alternativet kan bara anges på ett NULLHINTERNET-handtag innan en asynkron åtgärd har inträffat. Det här alternativet kan bara anges en gång.

Gäller för: Windows 7 och senare; Windows Server 2008 R2 och senare.

WINHTTP_OPTION_WRITE_BUFFER_SIZE

Det här alternativet är inaktuellt. det har ingen effekt.

Anmärkningar

I följande tabell visas alternativflaggor genom att ange vilka referenser de kan agera på, om de kan frågas och ställas in samt vilken datatyp som används. Ett "X" anger att alternativflaggan är giltig för användning med funktionen eller handtaget, medan en "-" anger att alternativflaggan är ogiltig.

Om du försöker ange eller köra frågor mot en alternativflagga i en Windows-version där den inte stöds resulterar det i ERROR_WINHTTP_INVALID_OPTION.

Alternativflagga och datatyp	Sessionshandtag	Begärandehandtag	Frågealternativ	Ange alternativ	Lägsta Windows-version
WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS BOOL	X	-	-	X	-
WINHTTP_OPTION_AUTOLOGON_POLICY DWORD	-	X	-	X	-
WINHTTP_OPTION_BACKGROUND_CONNECTIONS DWORD	X	-	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_CALLBACK LPVOID	X	X	X	X	-
WINHTTP_OPTION_CLIENT_CERT_CONTEXT CERT_CONTEXT	-	X	-	X	Windows Vista
WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST SecPkgContext_IssuerListInfoEx	-	X	X	-	Windows Vista
WINHTTP_OPTION_CODEPAGE DWORD	X	-	-	X	-
WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH DWORD	X	-	-	X	-
WINHTTP_OPTION_CONNECT_RETRIES DWORD	X	X	X	X	-
WINHTTP_OPTION_CONNECT_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_CONNECTION_INFO WINHTTP_CONNECTION_INFO	-	X	X	-	-
WINHTTP_OPTION_CONNECTION_STATS_V0 TCP_INFO_v0	-	X	X	-	Windows 10 Version 1903
WINHTTP_OPTION_CONNECTION_STATS_V1 TCP_INFO_v1	-	X	X	-	Windows 10 Version 2004
WINHTTP_OPTION_CONTEXT_VALUE DWORD_PTR	X	X	X	X	-
WINHTTP_OPTION_DECOMPRESSION DWORD	X	X	-	X	Windows 8.1
WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING BOOL	X	-	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_DISABLE_FEATURE DWORD	-	X	-	X	-
WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK BOOL	X	-	-	X	Windows 10 Version 1903
WINHTTP_OPTION_DISABLE_STREAM_QUEUE BOOL	X	X	-	X	Windows 10 Version 1809
WINHTTP_OPTION_ENABLE_FEATURE DWORD	*	*	-	X	-
WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL DWORD	X	X	-	X	Windows 10, version 1607
WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT_CONTEXT BOOL	X	-	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_ENABLETRACING DWORD	-	-	X	X	-
WINHTTP_OPTION_ENCODE_EXTRA BOOL	X	X	-	X	Windows 10 Version 1803
WINHTTP_OPTION_EXPIRE_CONNECTION Inte tillgänglig	-	X	-	X	Windows 10 Version 1903
WINHTTP_OPTION_EXTENDED_ERROR DWORD	X	X	X	-	-
WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION BOOL	X	-	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_GLOBAL_PROXY_CREDS WINHTTP_CREDS	X	X	-	X	-
WINHTTP_OPTION_GLOBAL_SERVER_CREDS WINHTTP_CREDS_EX	X	X	-	X	-
WINHTTP_OPTION_HANDLE_TYPE DWORD	X	X	X	-	-
WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED BOOL	X	X	-	X	Windows 10 Version 1903
WINHTTP_OPTION_HTTP_PROTOCOL_USED DWORD	-	X	X	-	Windows 10, version 1607
WINHTTP_OPTION_HTTP_VERSION HTTP_VERSION_INFO	X	X	X	X	-
WINHTTP_OPTION_HTTP2_KEEPALIVE DWORD	X	-	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING BOOL	X	X	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE BOOL	-	X	-	X	Windows 10 Version 2004
WINHTTP_OPTION_IPV6_FAST_FALLBACK BOOL	X	-	-	X	Windows 10 Version 1903
WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE BOOL	X	X	X	-	-
WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER DWORD	X	-	X	X	-
WINHTTP_OPTION_MAX_CONNS_PER_SERVER DWORD	X	-	X	X	-
WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS DWORD	X	X	X	X	-
WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE DWORD	X	X	X	X	-
WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE DWORD	X	X	X	X	-
WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE DWORD	X	X	X	X	-
WINHTTP_OPTION_PARENT_HANDLE HINTERNET	X	X	X	-	-
WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT LPWSTR	-	X	X	-	-
WINHTTP_OPTION_PASSPORT_COBRANDING_URL LPWSTR	-	X	X	-	-
WINHTTP_OPTION_PASSPORT_RETURN_URL LPVOID	-	X	X	-	-
WINHTTP_OPTION_PASSPORT_SIGN_OUT LPVOID	X	-	-	X	-
WINHTTP_OPTION_PASSWORD LPWSTR	-	X	X	X	-
WINHTTP_OPTION_PROXY WINHTTP_PROXY_INFO	X	X	X	X	-
WINHTTP_OPTION_PROXY_PASSWORD LPWSTR	-	X	X	X	-
WINHTTP_OPTION_PROXY_SPN_USED LPWSTR	-	X	X	-	-
WINHTTP_OPTION_PROXY_USERNAME LPWSTR	-	X	X	X	-
WINHTTP_OPTION_READ_BUFFER_SIZE DWORD	-	X	X	X	-
WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE BOOL	X	X	-	X	-
WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_RECEIVE_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_REDIRECT_POLICY DWORD	X	X	X	X	-
WINHTTP_OPTION_REJECT_USERPWD_IN_URL BOOL	-	X	-	X	-
WINHTTP_OPTION_REQUEST_PRIORITY DWORD	-	X	X	X	-
WINHTTP_OPTION_REQUEST_STATS WINHTTP_REQUEST_STATS	-	X	X	-	Windows 10 Version 1903
WINHTTP_OPTION_REQUEST_TIMES WINHTTP_REQUEST_TIMES	-	X	X	-	Windows 10 Version 1903
WINHTTP_OPTION_REQUIRE_STREAM_END BOOL	X	X	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_RESOLUTION_HOSTNAME LPWSTR	-	X	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_RESOLVE_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_SECURE_PROTOCOLS DWORD	X	-	-	X	-
WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT WINHTTP_CERTIFICATE_INFO	-	X	X	-	-
WINHTTP_OPTION_SECURITY_FLAGS DWORD	-	X	X	X	-
WINHTTP_OPTION_SECURITY_INFO WINHTTP_SECURITY_INFO	-	X	X	-	Windows 10 Version 2004
WINHTTP_OPTION_SECURITY_KEY_BITNESS DWORD	-	X	X	-	-
WINHTTP_OPTION_SEND_TIMEOUT DWORD	X	X	X	X	-
WINHTTP_OPTION_SERVER_CBT SecPkgContext_Bindings*	-	X	X	-	-
WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT CERT_CHAIN_CONTEXT	-	X	X	-	Windows 10 Version 2004
WINHTTP_OPTION_SERVER_CERT_CONTEXT CERT-KONTEXT	-	X	X	-	-
WINHTTP_OPTION_SERVER_SPN_USED LPWSTR	-	X	X	-	-
WINHTTP_OPTION_SPN DWORD	-	X	-	X	-
WINHTTP_OPTION_STREAM_ERROR_CODE DWORD	-	X	X	-	Windows 10 Version 21H1
WINHTTP_OPTION_TCP_FAST_OPEN BOOL	X	-	-	X	Windows 10 Version 2004
WINHTTP_OPTION_TCP_KEEPALIVE tcp_keepalive	X	-	-	X	Windows 10 Version 2004
WINHTTP_OPTION_TLS_FALSE_START BOOL	X	-	-	X	Windows 10 Version 2004
WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK BOOL	X	-	-	X	Windows 10 Version 21H1
WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT HINTERNET	X	-	-	X	-
WINHTTP_OPTION_UNSAFE_HEADER_PARSING DWORD	-	X	-	X	-
WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET Inte tillgänglig	-	X	-	X	-
WINHTTP_OPTION_URL LPWSTR	-	X	X	-	-
WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS BOOL	X	X	-	X	-
WINHTTP_OPTION_USER_AGENT LPWSTR	X	-	X	X	-
WINHTTP_OPTION_USERNAME LPWSTR	-	X	X	X	-
WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT DWORD	-	-	X	X	-
WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL DWORD	-	-	X	X	-
WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE DWORD	X	X	X	X	Windows 8.1
WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE DWORD	X	X	X	X	Windows 8.1
WINHTTP_OPTION_WORKER_THREAD_COUNT DWORD	-	-	-	X	-
WINHTTP_OPTION_WRITE_BUFFER_SIZE DWORD	-	X	X	X	-

Anmärkning

Information om Windows XP och Windows 2000 finns iRun-Time Krav.

Kravspecifikation

Krav	Värde
Lägsta klient som stöds	Windows XP, Windows 2000 Professional med SP3 [endast skrivbordsappar]
Lägsta server som stöds	Windows Server 2003, Windows 2000 Server med SP3 [endast skrivbordsappar]
Omdistribuerbar	WinHTTP 5.0 och Internet Explorer 5.01 eller senare i Windows XP och Windows 2000.
Rubrik	Winhttp.h

Se även

• WinHTTP-versioner