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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP], MSXML 6.0 e posterior |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | msxml6.h |