Interface IXMLHTTPRequest3 (msxml6.h)

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 .

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.

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

Confira também

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty