WinHttpRequestOption-Enumeration

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 eine VARIANT-Datei fest, die die Zeichenfolge des Benutzer-Agents enthält, oder ruft sie ab.

_WinHttpRequestOption-URL

Ruft eine VARIANT-Datei ab, die 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 aufgetreten ist.

WinHttpRequestOption _ URLCodePage

Legt eine VARIANT fest oder ruft sie ab, die die Codepage für die URL-Zeichenfolge identifiziert. Der Standardwert ist die UTF-8-Codepage. Die Codepage wird verwendet, um die In der Open-Methode übergebene Unicode-URL-Zeichenfolge in eine Einzel-Byte-Zeichenfolgendarstellung zu konvertieren.

WinHttpRequestOption _ EscapePercentInURL

Legt einen VARIANT fest oder ruft einen VARIANT ab, der angibt, ob Prozentzeichen in der URL-Zeichenfolge in eine Escapesequenz konvertiert werden. Der Standardwert dieser Option ist VARIANT _ TRUE, der alle UNSICHEREN ANSI-Zeichen (unsafe American National Standards Institute) mit Ausnahme des Prozentzeichens angibt, die in eine Escapesequenz konvertiert werden.

WinHttpRequestOption _ SslErrorIgnoreFlags

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

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

Der Standardwert dieser Option in Version 5.1 von WinHTTP ist 0 (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 Zertifikatspeicherund den Antragsteller eines Clientzertifikats an, die mit umgekehrten Schrägstrichen getrennt sind. Weitere Informationen zum Auswählen eines Clientzertifikats finden Sie unter SSL in WinHTTP.

WinHttpRequestOption _ EnableRedirects

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

WinHttpRequestOption _ UrlEscapeDisable

Legt einen VARIANT fest oder ruft einen VARIANT 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 fest oder ruft einen VARIANT ab, der angibt, ob unsichere Zeichen in der Abfragekomponente der URL in Escapesequenzen konvertiert werden. Der Standardwert dieser Option ist VARIANT _ TRUE, der angibt, dass Zeichen in der Abfrage konvertiert werden.

WinHttpRequestOption _ SecureProtocols

Legt einen VARIANT fest oder ruft einen VARIANT ab, der angibt, welche sicheren Protokolle verwendet werden können. 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 (null) 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 fest oder ruft einen VARIANT ab, der angibt, ob die Ablaufverfolgung derzeit aktiviert ist. Weitere Informationen zur Ablaufverfolgungsfunktion in Microsoft Windows HTTP Services (WinHTTP) finden Sie unter WinHTTP Trace Facility.

WinHttpRequestOption _ RevertImpersonationOverSsl

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

WinHttpRequestOption _ EnableHttpsToHttpRedirects

Steuert, ob WinHTTP Umleitungen zulässt. Standardmäßig werden alle Umleitungen automatisch befolgt, mit Ausnahme derjenigen, die von einer sicheren (HTTPS)-URL zu einer nicht sicheren (HTTP)-URL ü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 Passport-Authentifizierungsunterstützung 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 Erliegen kommen lassen.

Windows XP mit SP1 und Windows 2000 mit SP3: Dieser Enumerationswert wird nicht unterstützt.

WinHttpRequestOption _ MaxResponseHeaderSize

Legt einen gebundenen Satz für die maximale Größe des Headerteils der Serverantwort fest oder ruft diese ab. Diese Grenze schützt den Client vor einem böswilligen Server, der versucht, den Client zu lahmen, indem eine Antwort mit einer unendlichen Menge von Headerdaten gesendet wird. Der Standardwert ist 64 KB.

Windows XP mit SP1 und Windows 2000 mit SP3: Dieser Enumerationswert wird nicht unterstützt.

WinHttpRequestOption _ MaxResponseDrainSize

Legt eine Grenze für die Datenmenge fest, die aus Antworten entladen wird, um eine Verbindung wiederzuverwenden, oder ruft sie ab. Die Standardeinstellung ist 1 MB.

Windows XP mit SP1 und Windows 2000 mit SP3: Dieser Enumerationswert wird nicht unterstützt.

WinHttpRequestOption _ EnableHttp1 _ 1

Legt einen booleschen Wert fest, der angibt, ob HTTP/1.1 oder HTTP/1.0 verwendet werden soll, oder ruft diesen ab. Der Standardwert ist TRUE, sodass HTTP/1.1 standardmäßig verwendet wird.

Windows XP mit SP1 und Windows 2000 mit SP3: Dieser Enumerationswert wird nicht unterstützt.

WinHttpRequestOption _ EnableCertificateRevocationCheck

Aktiviert die Überprüfung der Serverzertifikatsperrung während der SSL-Aushandlung. Wenn der Server ein Zertifikat vorlegt, wird eine Überprüfung ausgeführt, um zu ermitteln, ob das Zertifikat vom Aussteller widerrufen wurde. Wenn das Zertifikat tatsächlich widerrufen wird oder die Sperrprüfung fehlschlägt, weil die Zertifikatsperrliste (Certificate Revocation List, CRL) nicht heruntergeladen werden kann, schlägt die Anforderung fehl. solche Sperrfehler können nicht unterdrückt werden.

Windows XP mit SP1 und Windows 2000 mit SP3: Dieser Enumerationswert wird nicht unterstützt.

Hinweise

Legen Sie eine Option fest, indem Sie eine der vorangehenden Konstanten als Parameter der Option-Eigenschaft angeben.

Hinweis

Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen der WinHttp-Startseite.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP, Windows 2000 Professional nur mit [ SP3-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003, Windows 2000 Server nur mit [ SP3-Desktop-Apps]
Verteilbare Komponente
WinHTTP 5.0 und Internet Explorer 5.01 oder höher auf Windows XP und Windows 2000.
IDL
HttpRequest.idl

Weitere Informationen

WinHTTP-Versionen