WinHttpRequestOption – výčet

Výčet WinHttpRequestOption obsahuje možnosti, které je možné nastavit nebo načíst pro aktuální relaci Služby HTTP systému Microsoft Windows (WinHTTP).

Syntaxe

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;

Konstanty

WinHttpRequestOption_UserAgentString

Nastaví nebo načte variantu , která obsahuje řetězec uživatelského agenta .

WinHttpRequestOption_URL

Načte variantu , která obsahuje adresu URL prostředku. Tato hodnota je jen pro čtení; Adresu URL nelze nastavit pomocí této vlastnosti. Adresu URL nelze přečíst, dokud není volána metoda Open . Tato možnost je užitečná pro kontrolu adresy URL po dokončení metody Odeslat a ověřit, zda došlo k přesměrování.

WinHttpRequestOption_URLCodePage

Nastaví nebo načte variantu , která identifikuje znakovou stránku řetězce adresy URL. Výchozí hodnota je znaková stránka UTF-8. Znaková stránka se používá k převodu řetězce adresy URL unicode předaného metodou Open na řetězcovou reprezentaci s jedním bajtem.

WinHttpRequestOption_EscapePercentInURL

Nastaví nebo načte variantu , která označuje, zda jsou procenta znaků v řetězci adresy URL převedeny na řídicí sekvenci. Výchozí hodnota této možnosti je VARIANT_TRUE , která určuje všechny nebezpečné znaky ANSI (American National Standards Institute) s výjimkou symbolu procenta jsou převedeny na řídicí sekvenci.

WinHttpRequestOption_SslErrorIgnoreFlags

Nastaví nebo načte variantu , která indikuje, které chyby certifikátu serveru by se měly ignorovat. Může se jednat o kombinaci jednoho nebo několika následujících příznaků.

Chyba	Hodnota
Neznámá certifikační autorita (CA) nebo nedůvěryhodný kořenový adresář	0x0100
Nesprávné využití	0x0200
Neplatný běžný název (CN)	0x1000
Neplatné datum nebo vypršení platnosti certifikátu	0x2000

Výchozí hodnota této možnosti ve verzi 5.1 winHTTP je nula, což vede k ignorování žádných chyb. Ve starších verzích WinHTTP bylo výchozí nastavení 0x3300, což ve výchozím nastavení vedlo k ignorování všech chyb certifikátu serveru.

WinHttpRequestOption_SelectCertificate

Nastaví variantu , která určuje klientský certifikát odeslaný na server pro ověření. Tato možnost označuje umístění, úložiště certifikátů a předmět klientského certifikátu odděleného zpětnými lomítky. Další informace o výběru klientského certifikátu najdete v tématu SSL ve službě WinHTTP.

WinHttpRequestOption_EnableRedirects

Nastaví nebo načte variantu , která určuje, jestli se požadavky automaticky přesměrují, když server určuje nové umístění prostředku. Výchozí hodnota této možnosti je VARIANT_TRUE označující, že se požadavky automaticky přesměrují.

WinHttpRequestOption_UrlEscapeDisable

Nastaví nebo načte variantu , která označuje, zda jsou nebezpečné znaky v cestě a součásti dotazu adresy URL převedeny na řídicí sekvence. Výchozí hodnota této možnosti je VARIANT_TRUE, která určuje, že se znaky v cestě a dotazu převedou.

WinHttpRequestOption_UrlEscapeDisableQuery

Nastaví nebo načte variantu , která označuje, zda jsou nebezpečné znaky v součásti dotazu adresy URL převedeny na řídicí sekvence. Výchozí hodnota této možnosti je VARIANT_TRUE, která určuje, že znaky v dotazu jsou převedeny.

WinHttpRequestOption_SecureProtocols

Nastaví nebo načte variantu , která označuje, které zabezpečené protokoly je možné použít. Tato možnost vybere protokoly přijatelné pro klienta. Protokol se vyjedná během metody handshake ssl (Secure Sockets Layer). Může se jednat o kombinaci jednoho nebo několika následujících příznaků.

Protokol	Hodnota
SSL 2.0	0x0008
SSL 3.0	0x0020
Tls (Transport Layer Security) 1.0	0x0080

Výchozí hodnota této možnosti je 0x0028, což značí, že lze použít SSL 2.0 nebo SSL 3.0. Pokud je tato možnost nastavená na nulu, klient a server nemůžou určit přijatelný protokol zabezpečení a další odeslání způsobí chybu.

WinHttpRequestOption_EnableTracing

Nastaví nebo načte variantu , která označuje, jestli je trasování aktuálně povolené. Viz také shromažďování trasování WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Určuje, jestli objekt WinHttpRequest dočasně vrátí zosobnění klienta po dobu trvání operací ověřování certifikátu SSL. Výchozí nastavení pro objekt WinHttpRequest je TRUE. Tuto možnost nastavte na FALSE , pokud chcete zachovat zosobnění při provádění operací ověřování certifikátů.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Určuje, jestli WinHTTP umožňuje přesměrování. Ve výchozím nastavení se za všemi přesměrováními automaticky postupuje, s výjimkou těch, které přenesou ze zabezpečené adresy URL (https) na nezabezpečenou adresu URL (http). Tuto možnost nastavte na TRUE , pokud chcete povolit přesměrování HTTPS na HTTP.

WinHttpRequestOption_EnablePassportAuthentication

Povolí nebo zakáže podporu ověřování Passportem. Ve výchozím nastavení je automatická podpora ověřování passportem zakázaná; Tuto možnost nastavte na TRUE , pokud chcete povolit podporu ověřování Passportem.

WinHttpRequestOption_MaxAutomaticRedirects

Nastaví nebo načte maximální počet přesměrování, které winHTTP sleduje; výchozí hodnota je 10. Tento limit brání neoprávněným lokalitám v tom, aby klient WinHTTP zastavil po velkém počtu přesměrování.