WinHttpRequestOption-uppräkning

Uppräkning av WinHttpRequestOption innehåller alternativ som kan anges eller hämtas för den aktuella WinHTTP-sessionen (Microsoft Windows HTTP Services).

Syntax

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

Konstanter

WinHttpRequestOption_UserAgentString

Anger eller hämtar en VARIANT som innehåller användaragentsträngen .

WinHttpRequestOption_URL

Hämtar en VARIANT som innehåller resursens URL. Det här värdet är skrivskyddat. du kan inte ange URL:en med den här egenskapen. Det går inte att läsa URL:en förrän metoden Öppna anropas. Det här alternativet är användbart för att kontrollera URL:en när metoden Skicka har slutförts för att verifiera att en omdirigering har inträffat.

WinHttpRequestOption_URLCodePage

Anger eller hämtar en VARIANT som identifierar kodsidan för URL-strängen. Standardvärdet är UTF-8-kodsidan. Kodsidan används för att konvertera Unicode-URL-strängen, som skickades i metoden Öppna , till en strängrepresentation med en enda byte.

WinHttpRequestOption_EscapePercentInURL

Anger eller hämtar en VARIANT som anger om procenttecken i URL-strängen konverteras till en escape-sekvens. Standardvärdet för det här alternativet är VARIANT_TRUE som anger alla osäkra ANSI-tecken (American National Standards Institute) förutom att procentsymbolen konverteras till en escape-sekvens.

WinHttpRequestOption_SslErrorIgnoreFlags

Anger eller hämtar en VARIANT som anger vilka servercertifikatfel som ska ignoreras. Detta kan vara en kombination av en eller flera av följande flaggor.

Fel	Värde
Okänd certifikatutfärdare (CA) eller ej betrodd rot	0x0100
Felaktig användning	0x0200
Ogiltigt eget namn (CN)	0x1000
Ogiltigt datum eller certifikat har upphört att gälla	0x2000

Standardvärdet för det här alternativet i version 5.1 av WinHTTP är noll, vilket resulterar i att inga fel ignoreras. I tidigare versioner av WinHTTP var standardinställningen 0x3300, vilket resulterade i att alla servercertifikatfel ignorerades som standard.

WinHttpRequestOption_SelectCertificate

Anger en VARIANT som anger det klientcertifikat som skickas till en server för autentisering. Det här alternativet anger plats, certifikatarkiv och ämne för ett klientcertifikat avgränsat med omvänt snedstreck. Mer information om hur du väljer ett klientcertifikat finns i SSL i WinHTTP.

WinHttpRequestOption_EnableRedirects

Anger eller hämtar en VARIANT som anger om begäranden omdirigeras automatiskt när servern anger en ny plats för resursen. Standardvärdet för det här alternativet är VARIANT_TRUE för att ange att begäranden omdirigeras automatiskt.

WinHttpRequestOption_UrlEscapeDisable

Anger eller hämtar en VARIANT som anger om osäkra tecken i sökvägen och frågekomponenterna i en URL konverteras till escape-sekvenser. Standardvärdet för det här alternativet är VARIANT_TRUE, som anger att tecken i sökvägen och frågan konverteras.

WinHttpRequestOption_UrlEscapeDisableQuery

Anger eller hämtar en VARIANT som anger om osäkra tecken i frågekomponenten i URL:en konverteras till escape-sekvenser. Standardvärdet för det här alternativet är VARIANT_TRUE, vilket anger att tecken i frågan konverteras.

WinHttpRequestOption_SecureProtocols

Anger eller hämtar en VARIANT som anger vilka säkra protokoll som kan användas. Det här alternativet väljer de protokoll som är godtagbara för klienten. Protokollet förhandlas under SSL-handskakningen (Secure Sockets Layer). Detta kan vara en kombination av en eller flera av följande flaggor.

Protokoll	Värde
SSL 2.0	0x0008
SSL 3.0	0x0020
Transport Layer Security (TLS) 1.0	0x0080

Standardvärdet för det här alternativet är 0x0028, vilket anger att SSL 2.0 eller SSL 3.0 kan användas. Om det här alternativet är inställt på noll kan klienten och servern inte fastställa ett acceptabelt säkerhetsprotokoll och nästa Skicka resulterar i ett fel.

WinHttpRequestOption_EnableTracing

Anger eller hämtar en VARIANT som anger om spårning är aktiverat för närvarande. Se även Samla in WinHTTP-spårningar.

WinHttpRequestOption_RevertImpersonationOverSsl

Styr om WinHttpRequest-objektet tillfälligt återställer klientpersonifiering under hela SSL-certifikatautentiseringsåtgärderna. Standardinställningen för WinHttpRequest-objektet är TRUE. Ställ in det här alternativet på FALSE för att behålla personifiering när du utför certifikatautentiseringsåtgärder.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Styr om WinHTTP tillåter omdirigeringar eller inte. Som standard följs alla omdirigeringar automatiskt, förutom de som överförs från en säker URL (https) till en icke-säker (http) URL. Ställ in det här alternativet på TRUE för att aktivera HTTPS till HTTP-omdirigeringar.

WinHttpRequestOption_EnablePassportAuthentication

Aktiverar eller inaktiverar stöd för Passport-autentisering. Som standard är automatiskt stöd för Passport-autentisering inaktiverat. ställ in det här alternativet på TRUE för att aktivera stöd för Passport-autentisering.

WinHttpRequestOption_MaxAutomaticRedirects

Anger eller hämtar det maximala antalet omdirigeringar som WinHTTP följer. standardvärdet är 10. Den här gränsen hindrar obehöriga webbplatser från att göra WinHTTP-klientstoppet efter ett stort antal omdirigeringar.