WinHttpRequestOption-Aufzählung

Die WinHttpRequestOption-Aufzählung enthält Optionen, die für die aktuelle Microsoft Windows HTTP Services (WinHTTP)-Sitzung 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 fest oder ruft einen VARIANT-Wert ab, der die Benutzer-Agent-Zeichenfolge enthält.

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 mithilfe dieser Eigenschaft festlegen. Die URL kann erst gelesen werden, wenn die Open-Methode aufgerufen wird. Diese Option ist nützlich, um die URL zu überprüfen, nachdem die Send-Methode abgeschlossen ist, um zu überprüfen, ob eine Umleitung aufgetreten ist.

WinHttpRequestOption_URLCodePage

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, der die Codeseite für die URL-Zeichenfolge identifiziert. Der Standardwert ist die UTF-8-Codeseite. Die Codeseite wird verwendet, um die Unicode-URL-Zeichenfolge zu konvertieren, die in der Open-Methode übergeben wird, in eine Einzelbyte-Zeichenfolgendarstellung.

WinHttpRequestOption_EscapePercentInURL

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, der angibt, ob Prozentzeichen in der URL-Zeichenfolge in eine Escapesequenz konvertiert werden. Der Standardwert dieser Option ist VARIANT_TRUE , der alle unsicheren American National Standards Institute (ANSI)-Zeichen mit Ausnahme des Prozentsymbols in eine Escapesequenz konvertiert.

WinHttpRequestOption_SslErrorIgnoreFlags

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, der angibt, welche Serverzertifikatfehler ignoriert werden sollen. Dies kann eine Kombination aus einer oder mehreren der folgenden Flags sein.

Fehler	Wert
Unbekannte Zertifizierungsstelle (Ca) oder nicht vertrauenswürdiger Stamm	0x0100
Falsche Verwendung	0x0200
Ungültiger allgemeiner 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 wurde 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 für die 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

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, 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

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, der angibt, ob unsichere Zeichen im 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

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, 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

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, der angibt, welche sicheren Protokolle verwendet werden können. Mit dieser Option werden die protokolle ausgewählt, die für den Client akzeptabel sind. Das Protokoll wird während des SSL-Handshakes (Secure Sockets Layer) ausgehandelt. Dies kann eine Kombination aus einer 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 Null festgelegt ist, kann der Client und der Server kein akzeptables Sicherheitsprotokoll ermitteln, und das nächste Senden führt zu einem Fehler.

WinHttpRequestOption_EnableTracing

Dient zum Festlegen oder Abrufen eines VARIANT-Werts, der angibt, ob die Ablaufverfolgung zurzeit aktiviert ist. Siehe auch "Sammeln von WinHTTP-Ablaufverfolgungen".

WinHttpRequestOption_RevertImpersonationOverSsl

Steuert, ob das WinHttpRequest-Objekt den Clientidentitätswechsel vorübergehend für die Dauer der SSL-Zertifikatauthentifizierungsvorgänge zurückstellt. 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 gefolgt, außer denen, die von einer sicheren (https)-URL zu einer nicht sicheren (http)-URL übertragen werden. Legen Sie diese Option auf TRUE fest, um HTTPS für 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 fest oder ruft die maximale Anzahl von Umleitungen ab, die WinHTTP folgt; Der Standardwert ist 10. Dieser Grenzwert verhindert, dass nicht autorisierte Websites den WinHTTP-Client nach einer großen Anzahl von Umleitungen hindern.