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

Ocorre quando um cliente recebe uma resposta completa do servidor.

Sintaxe

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

Parâmetros

[in, optional] pXHR

O objeto de solicitação HTTP inicial

[in, optional] pResponseStream

O fluxo de resposta que está sendo recebido. O cliente pode chamar ISequentialStream::Read para começar a processar os dados ou pode armazenar uma referência a pResponseStream para processamento posterior. Esse fluxo de resposta é encapsulado em um objeto de sincronização de fluxo que impede operações simultâneas de leitura e gravação, portanto, o aplicativo não precisa implementar a sincronização personalizada.

Retornar valor

Retornará S_OK se houver êxito.

Comentários

Quando esse evento dispara, o aplicativo pode começar a processar dados da resposta HTTP. O processamento poderá começar antes que esse evento seja acionado se um evento OnDataAvailable anterior tiver ocorrido.

A menos que OnError seja chamado, a chamada para OnResponseReceived é o retorno de chamada final. O cliente deve executar qualquer limpeza necessária, incluindo a liberação de referências para o objeto IXMLHTTPRequest2 .

Os fluxos personalizados recebem uma chamada para ISequentialStream::Write especificando 0 bytes gravados antes de OnResponseReceived ser acionado. O cliente pode processar dados diretamente da chamada write em vez de chamar ISequentialStream::Read no fluxo personalizado e pode contar com a chamada write de byte zero para indicar que a resposta foi recebida.

Requisitos

Confira também

ISequentialStream Interface

IXMLHTTPRequest2Callback