Interfaz IXMLHTTPRequest3 (msxml6.h)

  • Artículo

Proporciona los métodos y propiedades necesarios para configurar y enviar solicitudes HTTP y usar devoluciones de llamada para recibir notificaciones durante el procesamiento de respuesta HTTP. Deriva de la interfaz IXMLHTTPRequest2 .

Nota Esta interfaz se admite en Windows Phone 8.1.

 

Herencia

La interfaz IXMLHTTPRequest3 hereda de IXMLHTTPRequest2. IXMLHTTPRequest3 también tiene estos tipos de miembros:

Métodos

La interfaz IXMLHTTPRequest3 tiene estos métodos.

 
IXMLHTTPRequest3::SetClientCertificate

Establece un certificado de cliente que se usará para autenticarse en la dirección URL especificada en el método Open.

Comentarios

La interfaz IXMLHTTPRequest3 configura y envía solicitudes HTTP y usa devoluciones de llamada para recibir notificaciones durante el procesamiento de respuesta HTTP. La interfaz IXMLHTTPRequest3 permite que las aplicaciones se ejecuten en un apartamento multiproceso (MTA), un requisito para ejecutarse en el Windows Runtime (WinRT).

La interfaz IXMLHTTPRequest3 extiende la interfaz IXMLHTTPRequest2 .

Las interfaces IXMLHTTPRequest3 e IXMLHTTPRequest3Callback amplían las características proporcionadas por las interfaces IXMLHTTPRequest2 e IXMLHTTPRequest2Callback con estas adiciones:

  • Permite establecer un certificado de cliente que se usará para la solicitud HTTPS con el método SetClientCertificate en la interfaz IXMLHTTPRequest3 .
  • Permite obtener una lista de emisores para ayudar a filtrar los certificados de cliente aptos que se usarán para la siguiente solicitud HTTP con el método OnClientCertificateRequested en la interfaz IXMLHTTPRequest3Callback .
  • Permite omitir ciertos errores de certificado que, de lo contrario, habrían anulado la conexión HTTPS.
  • Permite obtener errores de certificado y la cadena de certificados de servidor de la respuesta HTTPS con el método OnServerCertificateReceived en la interfaz IXMLHTTPRequest3Callback .

El método SetProperty de la interfaz IXMLHTTPRequest2 se extiende en la interfaz IXMLHTTPRequest3 con nuevas propiedades para admitir nuevos escenarios:

  • XHR_PROP_NO_CACHE: suprime las lecturas y escrituras de caché para la solicitud HTTP.
  • XHR_PROP_EXTENDED_ERROR: hace que la pila HTTP proporcione HRESULTS con el código de error subyacente de Win32 al método OnError en caso de error.
  • XHR_PROP_QUERY_STRING_UTF8: hace que la cadena de consulta se codifique en UTF-8 en lugar de ACP para la solicitud HTTP.
  • XHR_PROP_IGNORE_CERT_ERRORS: suprime determinados errores de certificado de servidor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msxml6.h

Consulte también

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty