Método IXMLHTTPRequest2Callback::OnResponseReceived (msxml6.h)

Se produce cuando un cliente ha recibido una respuesta completa del servidor.

Sintaxis

HRESULT OnResponseReceived(
  [in, optional] IXMLHTTPRequest2  *pXHR,
  [in, optional] ISequentialStream *pResponseStream
);

Parámetros

[in, optional] pXHR

Objeto de solicitud HTTP inicial

[in, optional] pResponseStream

Flujo de respuesta que se recibe. El cliente puede llamar a ISequentialStream::Read para comenzar a procesar los datos o puede almacenar una referencia a pResponseStream para su posterior procesamiento. Esta secuencia de respuesta se ajusta en un objeto de sincronización de flujos que impide operaciones simultáneas de lectura y escritura, por lo que la aplicación no necesita implementar la sincronización personalizada.

Valor devuelto

Devuelve S_OK si se realiza correctamente.

Nota Esta función de devolución de llamada no debe producir excepciones.

 

Comentarios

Cuando se activa este evento, la aplicación puede comenzar a procesar datos de la respuesta HTTP. El procesamiento puede comenzar antes de que se active este evento si se ha producido un evento OnDataAvailable anterior.

A menos que se llame a OnError , la llamada a OnResponseReceived es la devolución de llamada final. El cliente debe realizar cualquier limpieza necesaria, incluida la liberación de referencias al objeto IXMLHTTPRequest2 .

Las secuencias personalizadas reciben una llamada a ISequentialStream::Write especificando 0 bytes escritos antes de que se desencadene OnResponseReceived . El cliente puede procesar los datos directamente desde la llamada de escritura en lugar de llamar a ISequentialStream::Read en la secuencia personalizada y puede basarse en la llamada write de cero bytes para indicar que se ha recibido la respuesta.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP],MSXML 6.0 y versiones posteriores
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msxml6.h

Consulte también

ISequentialStream (interfaz)

IXMLHTTPRequest2Callback