Método IXMLHTTPRequest2::SetProperty (msxml6.h)

  • Artigo

Define uma propriedade em uma solicitação HTTP de saída.

Sintaxe

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

Parâmetros

[in] eProperty

Os seguintes valores são válidos:

Valor Significado
XHR_PROP_NO_CRED_PROMPT
 Suprime as solicitações automáticas de credenciais do usuário
XHR_PROP_NO_AUTH
 Suprime a autenticação que a pilha HTTP executa em nome do aplicativo
XHR_PROP_TIMEOUT
 Define todos os valores de tempo limite para o valor fornecido por ullValue, em milissegundos.
XHR_PROP_NO_DEFAULT_HEADERS
 Suprime a adição de cabeçalhos padrão à solicitação HTTP.
XHR_PROP_REPORT_REDIRECT_STATUS
 Faz com que a pilha HTTP chame o método OnHeadersAvailable com um redirecionamento provisório status código. O método OnHeadersAvailable será chamado novamente para redirecionamentos adicionais e o destino final status código.
XHR_PROP_NO_CACHE
 Suprime leituras e gravações de cache para a solicitação HTTP.

Essa propriedade é compatível com a interface IXMLHTTPRequest3 .
XHR_PROP_EXTENDED_ERROR
 Faz com que a pilha HTTP forneça HRESULTS com o código de erro Win32 subjacente para o método OnError em caso de falha.

Essa propriedade é compatível com a interface IXMLHTTPRequest3 .
XHR_PROP_QUERY_STRING_UTF8
Faz com que a cadeia de caracteres de consulta seja codificada em UTF-8 em vez de ACP para a solicitação HTTP.

Essa propriedade é compatível com a interface IXMLHTTPRequest3 .
XHR_PROP_IGNORE_CERT_ERRORS
 Suprime determinados erros de certificado.

Essa propriedade é compatível com a interface IXMLHTTPRequest3 .

[in] ullValue

Especifica o número de milissegundos que o aplicativo aguarda antes de atingir o tempo limite.

Valor Significado
XHR_PROP_NO_CRED_PROMPT
 Esse parâmetro pode ser um dos valores do tipo de enumeração XHR_CRED_PROMPT definido no arquivo de cabeçalho Msxml6.h .
  • XHR_CRED_PROMPT_ALL se a solicitação de credencial deve ser habilitada (padrão).
  • XHR_CRED_PROMPT_NONE se a solicitação de credencial deve ser desabilitada.
  • XHR_CRED_PROMPT_PROXY se a solicitação de credencial só deve ser habilitada para autenticação de proxy.
XHR_PROP_NO_AUTH
 Esse parâmetro pode ser um dos valores do tipo de enumeração XHR_AUTH definido no arquivo de cabeçalho Msxml6.h .
  • XHR_AUTH_ALL se a autenticação estiver habilitada (padrão).
  • XHR_AUTH_NONE se a autenticação estiver desabilitada.
  • XHR_AUTH_PROXY se a autenticação só deve ser habilitada para autenticação de proxy.
XHR_PROP_TIMEOUT
O número de milissegundos, até 0xFFFFFFFF, que o aplicativo espera antes de atingir o tempo limite.
XHR_PROP_NO_DEFAULT_HEADERS
  • FALSE(0x0) para habilitar a adição de cabeçalhos padrão (padrão).
  • TRUE(0x1) para desabilitar a adição de cabeçalhos padrão.
XHR_PROP_REPORT_REDIRECT_STATUS
  • FALSE(0x0) para não relatar status de redirecionamento (padrão).
  • TRUE(0x1) para relatar status de redirecionamento.
XHR_PROP_NO_CACHE
  • FALSE(0x0) para habilitar o cache (padrão).
  • TRUE(0x1) para desabilitar o cache.
XHR_PROP_EXTENDED_ERROR
  • FALSE(0x0) para não fornecer erros estendidos (padrão).
  • TRUE(0x1) para fornecer erros estendidos.
XHR_PROP_QUERY_STRING_UTF8
  • FALSE(0x0) para não codificar a cadeia de caracteres de consulta em UTF-8 (padrão).
  • TRUE(0x1) para codificar a cadeia de caracteres de consulta em UTF-8.
XHR_PROP_IGNORE_CERT_ERRORS
  • FALSE(0x0) para não ignorar erros de certificado (padrão).
  • TRUE(0x1) para ignorar erros de certificado.

Retornar valor

Retornará S_OK se houver êxito.

Comentários

O método SetProperty na interface IXMLHTTPRequest2 é estendido na interface IXMLHTTPRequest3 com novas propriedades para dar suporte a novos cenários:

  • XHR_PROP_NO_CACHE – suprime leituras e gravações de cache para a solicitação HTTP.
  • XHR_PROP_EXTENDED_ERROR – faz com que a pilha HTTP forneça HRESULTS com o código de erro Win32 subjacente para o método OnError em caso de falha.
  • XHR_PROP_QUERY_STRING_UTF8 – faz com que a cadeia de caracteres de consulta seja codificada em UTF-8 em vez de ACP para solicitação HTTP.
  • XHR_PROP_IGNORE_CERT_ERRORS – suprime determinados erros de certificado do servidor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP], MSXML 6.0 e posterior
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msxml6.h

Confira também

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

Abrir

Enumeração XHR_PROPERTY