WinHttpRequestOption-Enumeration

Artikel
06/03/2023

Die WinHttpRequestOption-Enumeration enthält Optionen, die für die aktuelle WinHTTP-Sitzung (Microsoft Windows HTTP Services) festgelegt oder abgerufen werden können.

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;

Konstanten

WinHttpRequestOption_UserAgentString

Legt einen VARIANT-Wert fest, der die Benutzer-Agent-Zeichenfolge enthält, oder ruft diesen ab.

WinHttpRequestOption_URL

Ruft einen VARIANT-Wert ab, der die URL der Ressource enthält. Dieser Wert ist schreibgeschützt. Sie können die URL nicht mit dieser Eigenschaft festlegen. Die URL kann erst gelesen werden, wenn die Open-Methode aufgerufen wird. Diese Option ist nützlich, um die URL nach Abschluss der Send-Methode zu überprüfen, um zu überprüfen, ob eine Umleitung erfolgt ist.

WinHttpRequestOption_URLCodePage

Legt einen VARIANT-Wert fest, der die Codepage für die URL-Zeichenfolge identifiziert, oder ruft diesen ab. Der Standardwert ist die UTF-8-Codepage. Die Codepage wird verwendet, um die unicode-URL-Zeichenfolge, die in der Open-Methode übergeben wird, in eine Einzelbyte-Zeichenfolgendarstellung zu konvertieren.

WinHttpRequestOption_EscapePercentInURL

Legt einen VARIANT-Wert fest, der angibt, ob Prozentzeichen in der URL-Zeichenfolge in eine Escapesequenz konvertiert werden, oder ruft diesen ab. Der Standardwert dieser Option ist VARIANT_TRUE , der angibt, dass alle unsicheren Zeichen des American National Standards Institute (ANSI) außer dem Prozentsymbol in eine Escapesequenz konvertiert werden.

WinHttpRequestOption_SslErrorIgnoreFlags

Legt einen VARIANT-Wert fest, der angibt, welche Serverzertifikatfehler ignoriert werden sollen, oder ruft diesen ab. Dies kann eine Kombination aus einem oder mehreren der folgenden Flags sein.

Fehler	Wert
Unbekannte Zertifizierungsstelle (CA) oder nicht vertrauenswürdiger Stamm	0x0100
Falsche Verwendung	0x0200
Ungültiger allgemeiner Name (Common Name, CN)	0x1000
Ungültiges Datum oder abgelaufenes Zertifikat	0x2000

Der Standardwert dieser Option in Version 5.1 von WinHTTP ist null, was dazu führt, dass keine Fehler ignoriert werden. In früheren Versionen von WinHTTP war die Standardeinstellung 0x3300, was dazu führte, dass alle Serverzertifikatfehler standardmäßig ignoriert wurden.

WinHttpRequestOption_SelectCertificate

Legt einen VARIANT-Wert fest, der das Clientzertifikat angibt, das zur Authentifizierung an einen Server gesendet wird. Diese Option gibt den Speicherort, den Zertifikatspeicher und den Betreff eines Clientzertifikats an, das durch umgekehrte Schrägstriche getrennt ist. Weitere Informationen zum Auswählen eines Clientzertifikats finden Sie unter SSL in WinHTTP.

WinHttpRequestOption_EnableRedirects

Legt einen VARIANT-Wert fest, der angibt, ob Anforderungen automatisch umgeleitet werden, wenn der Server einen neuen Speicherort für die Ressource angibt, oder ruft diesen ab. Der Standardwert dieser Option ist VARIANT_TRUE , um anzugeben, dass Anforderungen automatisch umgeleitet werden.

WinHttpRequestOption_UrlEscapeDisable

Legt fest oder ruft einen VARIANT-Wert ab, der angibt, ob unsichere Zeichen in den Pfad- und Abfragekomponenten einer URL in Escapesequenzen konvertiert werden. Der Standardwert dieser Option ist VARIANT_TRUE, der angibt, dass Zeichen im Pfad und in der Abfrage konvertiert werden.

WinHttpRequestOption_UrlEscapeDisableQuery

Legt einen VARIANT-Wert fest, der angibt, ob unsichere Zeichen in der Abfragekomponente der URL in Escapesequenzen konvertiert werden, oder ruft diesen ab. Der Standardwert dieser Option ist VARIANT_TRUE, der angibt, dass Zeichen in der Abfrage konvertiert werden.

WinHttpRequestOption_SecureProtocols

Legt einen VARIANT-Wert fest, der angibt, welche sicheren Protokolle verwendet werden können, oder ruft diesen ab. Mit dieser Option werden die Protokolle ausgewählt, die für den Client zulässig sind. Das Protokoll wird während des SSL-Handshakes (Secure Sockets Layer) ausgehandelt. Dies kann eine Kombination aus einem oder mehreren der folgenden Flags sein.

Protokoll	Wert
SSL 2.0	0x0008
SSL 3.0	0x0020
Transport Layer Security (TLS) 1.0	0x0080

Der Standardwert dieser Option ist 0x0028, was angibt, dass SSL 2.0 oder SSL 3.0 verwendet werden kann. Wenn diese Option auf 0 festgelegt ist, können Client und Server kein akzeptables Sicherheitsprotokoll ermitteln, und das nächste Senden führt zu einem Fehler.

WinHttpRequestOption_EnableTracing

Legt einen VARIANT-Wert fest, der angibt, ob die Ablaufverfolgung derzeit aktiviert ist, oder ruft diesen ab. Weitere Informationen finden Sie unter Sammeln von WinHTTP-Ablaufverfolgungen.

WinHttpRequestOption_RevertImpersonationOverSsl

Steuert, ob das WinHttpRequest-Objekt den Clientidentitätswechsel für die Dauer der SSL-Zertifikatauthentifizierungsvorgänge vorübergehend zurückgibt. Die Standardeinstellung für das WinHttpRequest-Objekt ist TRUE. Legen Sie diese Option auf FALSE fest, um den Identitätswechsel beim Ausführen von Zertifikatauthentifizierungsvorgängen beizubehalten.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Steuert, ob WinHTTP Umleitungen zulässt. Standardmäßig werden alle Umleitungen automatisch befolgt, mit Ausnahme von Umleitungen, die von einer sicheren URL (https) zu einer nicht sicheren URL (HTTP) übertragen werden. Legen Sie diese Option auf TRUE fest, um HTTPS-zu-HTTP-Umleitungen zu aktivieren.

WinHttpRequestOption_EnablePassportAuthentication

Aktiviert oder deaktiviert die Unterstützung für die Passport-Authentifizierung. Standardmäßig ist die automatische Unterstützung für die Passport-Authentifizierung deaktiviert. Legen Sie diese Option auf TRUE fest, um die Unterstützung der Passport-Authentifizierung zu aktivieren.

WinHttpRequestOption_MaxAutomaticRedirects

Legt die maximale Anzahl von Umleitungen fest, die WinHTTP folgt, oder ruft sie ab. der Standardwert ist 10. Dieser Grenzwert verhindert, dass nicht autorisierte Websites den WinHTTP-Client nach einer großen Anzahl von Umleitungen zum Stillstand führen.