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

Se produce cuando un cliente recibe parte de los datos de respuesta HTTP del servidor.

Sintaxis

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

Parámetros

[in, optional] pXHR

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 esperar hasta que haya recibido la respuesta completa. Esta secuencia de respuesta se ajusta en un objeto de sincronización de secuencias 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 esta función de devolución de llamada devuelve la aplicación puede comenzar a procesar datos de la respuesta HTTP, incluso si aún no ha recibido toda la respuesta. Sin embargo, la recepción se suspende para la solicitud hasta que se devuelva esta función de devolución de llamada. Además, esta devolución de llamada se puede invocar varias veces durante una sola solicitud.

Esta función de devolución de llamada no debe bloquearse y no debe realizarse para realizar operaciones que consumen muchos recursos, como las actualizaciones de la interfaz de usuario.

Las secuencias personalizadas reciben una llamada a ISequentialStream::Write antes de que se desencadene OnDataAvailable . El cliente puede procesar datos directamente desde la llamada de escritura en lugar de llamar a ISequentialStream::Read en la secuencia personalizada y puede confiar en la llamada de escritura para indicar que hay nuevos datos disponibles.

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