Compartilhar via

Interface IXMLHTTPRequest3 (msxml6.h)

  • Artigo

Fornece os métodos e propriedades necessários para configurar e enviar solicitações HTTP e usar retornos de chamada para receber notificações durante o processamento da resposta HTTP. Deriva da interface IXMLHTTPRequest2 .

Nota Essa interface tem suporte no Windows Phone 8.1.

 

Herança

A interface IXMLHTTPRequest3 herda de IXMLHTTPRequest2. IXMLHTTPRequest3 também tem estes tipos de membros:

Métodos

A interface IXMLHTTPRequest3 tem esses métodos.

 
IXMLHTTPRequest3::SetClientCertificate

Define um certificado de cliente a ser usado para autenticar na URL especificada no método Open.

Comentários

A interface IXMLHTTPRequest3 configura e envia solicitações HTTP e usa retornos de chamada para receber notificações durante o processamento da resposta HTTP. A interface IXMLHTTPRequest3 permite que os aplicativos sejam executados em um MTA (multi-threaded apartment), um requisito para execução no Windows Runtime (WinRT).

A interface IXMLHTTPRequest3 estende a interface IXMLHTTPRequest2 .

As interfaces IXMLHTTPRequest3 e IXMLHTTPRequest3Callback estendem os recursos fornecidos pelas interfaces IXMLHTTPRequest2 e IXMLHTTPRequest2Callback com estas adições:

  • Permite definir um certificado de cliente a ser usado para a solicitação HTTPS com o método SetClientCertificate na interface IXMLHTTPRequest3 .
  • Permite obter uma lista de emissores para ajudar a filtrar certificados de cliente qualificados a serem usados para a próxima solicitação HTTP com o método OnClientCertificateRequested na interface IXMLHTTPRequest3Callback .
  • Permite ignorar determinados erros de certificado que, de outra forma, teriam anulado a conexão HTTPS.
  • Permite obter erros de certificado e a cadeia de certificados do servidor da resposta HTTPS com o método OnServerCertificateReceived na interface IXMLHTTPRequest3Callback .

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.1 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msxml6.h

Confira também

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty