WinHttpRequestOption enumeração

A enumeração WinHttpRequestOption inclui opções que podem ser definidas ou recuperadas para a sessão atual do Microsoft Windows HTTP Services (WinHTTP).

Sintaxe

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;

Constantes

WinHttpRequestOption_UserAgentString

Define ou recupera uma VARIANT que contém a cadeia de caracteres do agente do usuário .

WinHttpRequestOption_URL

Recupera uma VARIANT que contém a URL do recurso. Esse valor é somente leitura; você não pode definir a URL usando essa propriedade. A URL não pode ser lida até que o método Open seja chamado. Essa opção é útil para verificar a URL após a conclusão do método Send para verificar se ocorreu algum redirecionamento.

WinHttpRequestOption_URLCodePage

Define ou recupera uma VARIANT que identifica a página de código para a cadeia de caracteres de URL. O valor padrão é a página de código UTF-8. A página de código é usada para converter a cadeia de caracteres de URL Unicode, passada no método Open , em uma representação de cadeia de caracteres de byte único.

WinHttpRequestOption_EscapePercentInURL

Define ou recupera uma VARIANT que indica se os caracteres de porcentagem na cadeia de caracteres de URL são convertidos em uma sequência de escape. O valor padrão dessa opção é VARIANT_TRUE que especifica todos os caracteres não seguros do American National Standards Institute (ANSI), exceto o símbolo de porcentagem são convertidos em uma sequência de escape.

WinHttpRequestOption_SslErrorIgnoreFlags

Define ou recupera uma VARIANT que indica quais erros de certificado de servidor devem ser ignorados. Isso pode ser uma combinação de um ou mais dos seguintes sinalizadores.

Erro	Valor
Autoridade de certificação (CA) desconhecida ou raiz não confiável	0x0100
Utilização errada	0x0200
Denominação comum (CN) inválida	0x1000
Data inválida ou certificado expirado	0x2000

O valor padrão dessa opção na versão 5.1 do WinHTTP é zero, o que resulta em nenhum erro sendo ignorado. Em versões anteriores do WinHTTP, a configuração padrão era 0x3300, o que resultava em todos os erros de certificado do servidor sendo ignorados por padrão.

WinHttpRequestOption_SelectCertificate

Define uma VARIANT que especifica o certificado de cliente que é enviado a um servidor para autenticação. Essa opção indica o local, o armazenamento de certificados e o assunto de um certificado de cliente delimitado com barras invertidas. Para obter mais informações sobre como selecionar um certificado de cliente, consulte SSL no WinHTTP.

WinHttpRequestOption_EnableRedirects

Define ou recupera uma VARIANT que indica se as solicitações são redirecionadas automaticamente quando o servidor especifica um novo local para o recurso. O valor padrão dessa opção é VARIANT_TRUE para indicar que as solicitações são redirecionadas automaticamente.

WinHttpRequestOption_UrlEscapeDisable

Define ou recupera uma VARIANT que indica se caracteres não seguros no caminho e componentes de consulta de uma URL são convertidos em sequências de escape. O valor padrão dessa opção é VARIANT_TRUE, que especifica que os caracteres no caminho e na consulta são convertidos.

WinHttpRequestOption_UrlEscapeDisableQuery

Define ou recupera uma VARIANT que indica se caracteres não seguros no componente de consulta da URL são convertidos em sequências de escape. O valor padrão dessa opção é VARIANT_TRUE, que especifica que os caracteres na consulta são convertidos.

WinHttpRequestOption_SecureProtocols

Define ou recupera uma VARIANT que indica quais protocolos seguros podem ser usados. Esta opção seleciona os protocolos aceitáveis para o cliente. O protocolo é negociado durante o handshake SSL (Secure Sockets Layer). Isso pode ser uma combinação de um ou mais dos seguintes sinalizadores.

Protocolo	Valor
SSL 2,0	0x0008
SSL 3,0	0x0020
Segurança da camada de transporte (TLS) 1.0	0x0080

O valor padrão dessa opção é 0x0028, o que indica que SSL 2.0 ou SSL 3.0 pode ser usado. Se essa opção estiver definida como zero, o cliente e o servidor não poderão determinar um protocolo de segurança aceitável e o próximo Enviar resultará em um erro.

WinHttpRequestOption_EnableTracing

Define ou recupera uma VARIANT que indica se o rastreamento está habilitado no momento. Consulte também Coletar rastreamentos WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Controla se o objeto WinHttpRequest reverte temporariamente a representação do cliente durante as operações de autenticação do certificado SSL. A configuração padrão para o objeto WinHttpRequest é TRUE. Defina essa opção como FALSE para manter a representação durante a execução de operações de autenticação de certificado.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Controla se o WinHTTP permite ou não redirecionamentos. Por padrão, todos os redirecionamentos são seguidos automaticamente, exceto aqueles que são transferidos de um URL seguro (https) para um URL não seguro (http). Defina essa opção como TRUE para habilitar redirecionamentos HTTPS para HTTP.

WinHttpRequestOption_EnablePassportAuthentication

Habilita ou desabilita o suporte para autenticação do Passport. Por padrão, o suporte automático para autenticação do Passport está desativado; defina essa opção como TRUE para habilitar o suporte à autenticação do Passport.

WinHttpRequestOption_MaxAutomaticRedirects

Define ou recupera o número máximo de redirecionamentos que WinHTTP segue; o padrão é 10. Esse limite impede que sites não autorizados façam o cliente WinHTTP parar após um grande número de redirecionamentos.