Enumeração WinHttpRequestOption

Artigo
06/13/2023

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

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 um 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; não é possível 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 depois que o método Send é concluído para verificar se ocorreu qualquer redirecionamento.

WinHttpRequestOption_URLCodePage

Define ou recupera um VARIANT que identifica a página de código da 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 um 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 ansi (American National Standards Institute) não seguros, exceto que o símbolo de porcentagem é convertido em uma sequência de escape.

WinHttpRequestOption_SslErrorIgnoreFlags

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

Erro	Valor
AC (autoridade de certificação) desconhecida ou raiz não confiável	0x0100
Uso incorreto	0x0200
CN (nome comum) inválido	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 um VARIANT que especifica o certificado do cliente que é enviado a um servidor para autenticação. Essa opção indica o local, o repositório 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 um 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 um VARIANT que indica se caracteres não seguros no caminho e nos 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 um 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 um VARIANT que indica quais protocolos seguros podem ser usados. Essa 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 sinalizadores a seguir.

Protocolo	Valor
SSL 2.0	0x0008
SSL 3.0	0x0020
Protocolo TLS 1.0	0x0080

O valor padrão dessa opção é 0x0028, que indica que O 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 Envio resultará em um erro.

WinHttpRequestOption_EnableTracing

Define ou recupera um 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 de 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 transferem de uma URL segura (https) para uma URL não segura (http). Defina essa opção como TRUE para habilitar o HTTPS para redirecionamentos 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á desabilitado; 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 o 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.