WinHttpRequestOption, wyliczenie

Wyliczenie WinHttpRequestOption zawiera opcje, które można ustawić lub pobrać dla bieżącej sesji usług HTTP systemu Microsoft Windows (WinHTTP).

Składnia

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;

Stałe

WinHttpRequestOption_UserAgentString

Ustawia lub pobiera wariant zawierający ciąg agenta użytkownika .

WinHttpRequestOption_URL

Pobiera wariant zawierający adres URL zasobu. Ta wartość jest tylko do odczytu; Nie można ustawić adresu URL przy użyciu tej właściwości. Nie można odczytać adresu URL, dopóki nie zostanie wywołana metoda Open . Ta opcja jest przydatna do sprawdzania adresu URL po zakończeniu metody Send w celu sprawdzenia, czy wystąpiło przekierowanie.

WinHttpRequestOption_URLCodePage

Ustawia lub pobiera WARIANT , który identyfikuje stronę kodową ciągu adresu URL. Wartość domyślna to strona kodowa UTF-8. Strona kodowa służy do konwertowania ciągu adresu URL Unicode przekazanego w metodzie Open na reprezentację ciągu jedno bajtowego.

WinHttpRequestOption_EscapePercentInURL

Ustawia lub pobiera wariant wskazujący, czy znaki procentowe w ciągu adresu URL są konwertowane na sekwencję ucieczki. Wartością domyślną tej opcji jest VARIANT_TRUE , która określa wszystkie niebezpieczne znaki Amerykańskiego Narodowego Instytutu Standardów (ANSI), z wyjątkiem symbolu procentu są konwertowane na sekwencję ucieczki.

WinHttpRequestOption_SslErrorIgnoreFlags

Ustawia lub pobiera wariant wskazujący, które błędy certyfikatu serwera powinny być ignorowane. Może to być kombinacja co najmniej jednej z następujących flag.

Błąd	Wartość
Nieznany urząd certyfikacji (CA) lub niezaufany katalog główny	0x0100
Nieprawidłowe użycie	0x0200
Nieprawidłowa nazwa pospolita (CN)	0x1000
Nieprawidłowa data lub certyfikat wygasł	0x2000

Wartość domyślna tej opcji w wersji 5.1 winHTTP wynosi zero, co nie powoduje ignorowania błędów. We wcześniejszych wersjach winHTTP domyślne ustawienie było 0x3300, co spowodowało, że wszystkie błędy certyfikatów serwera były domyślnie ignorowane.

WinHttpRequestOption_SelectCertificate

Ustawia wariant określający certyfikat klienta, który jest wysyłany do serwera na potrzeby uwierzytelniania. Ta opcja wskazuje lokalizację, magazyn certyfikatów i podmiot certyfikatu klienta rozdzielany ukośnikami odwrotnymi. Aby uzyskać więcej informacji na temat wybierania certyfikatu klienta, zobacz Protokół SSL w usłudze WinHTTP.

WinHttpRequestOption_EnableRedirects

Ustawia lub pobiera wariant wskazujący, czy żądania są automatycznie przekierowywane, gdy serwer określa nową lokalizację zasobu. Wartość domyślna tej opcji jest VARIANT_TRUE wskazywać, że żądania są automatycznie przekierowywane.

WinHttpRequestOption_UrlEscapeDisable

Ustawia lub pobiera wariant wskazujący, czy niebezpieczne znaki w ścieżce i składnikach zapytania adresu URL są konwertowane na sekwencje ucieczki. Wartość domyślna tej opcji to VARIANT_TRUE, która określa, że znaki w ścieżce i zapytaniu są konwertowane.

WinHttpRequestOption_UrlEscapeDisableQuery

Ustawia lub pobiera wariant wskazujący, czy niebezpieczne znaki w składniku zapytania adresu URL są konwertowane na sekwencje ucieczki. Wartość domyślna tej opcji to VARIANT_TRUE, która określa, że znaki w zapytaniu są konwertowane.

WinHttpRequestOption_SecureProtocols

Ustawia lub pobiera WARIANT , który wskazuje, które bezpieczne protokoły mogą być używane. Ta opcja wybiera protokoły akceptowalne dla klienta. Protokół jest negocjowany podczas uzgadniania protokołu Secure Sockets Layer (SSL). Może to być kombinacja co najmniej jednej z następujących flag.

Protokół	Wartość
SSL 2.0	0x0008
SSL 3.0	0x0020
Transport Layer Security (TLS) 1.0	0x0080

Wartość domyślna tej opcji to 0x0028, która wskazuje, że można użyć protokołu SSL 2.0 lub SSL 3.0. Jeśli ta opcja jest ustawiona na zero, klient i serwer nie mogą określić akceptowalnego protokołu zabezpieczeń, a następne wysyłanie powoduje wystąpienie błędu.

WinHttpRequestOption_EnableTracing

Ustawia lub pobiera wariant wskazujący, czy śledzenie jest obecnie włączone. Zobacz również Zbieranie śladów WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Określa, czy obiekt WinHttpRequest tymczasowo przywraca personifikację klienta przez czas trwania operacji uwierzytelniania certyfikatu SSL. Ustawieniem domyślnym obiektu WinHttpRequest jest true. Ustaw tę opcję na FAŁSZ , aby zachować personifikację podczas wykonywania operacji uwierzytelniania certyfikatu.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Określa, czy usługa WinHTTP zezwala na przekierowania. Domyślnie wszystkie przekierowania są automatycznie obserwowane, z wyjątkiem tych, które są przenoszone z bezpiecznego adresu URL (https) do adresu URL niezabezpieczonego (http). Ustaw tę opcję na wartość TRUE , aby włączyć przekierowania HTTP za pomocą protokołu HTTPS.

WinHttpRequestOption_EnablePassportAuthentication

Włącza lub wyłącza obsługę uwierzytelniania usługi Passport. Domyślnie automatyczna obsługa uwierzytelniania usługi Passport jest wyłączona; ustaw tę opcję na wartość TRUE , aby włączyć obsługę uwierzytelniania usługi Passport.

WinHttpRequestOption_MaxAutomaticRedirects

Ustawia lub pobiera maksymalną liczbę przekierowań, które następuje po winHTTP; wartość domyślna to 10. Ten limit uniemożliwia nieautoryzowanym witrynom zatrzymanie klienta WinHTTP po dużej liczbie przekierowań.