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

Artigo
08/25/2023

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