Share via

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

  • Artigo

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.

Nota Essa função de retorno de chamada não deve gerar exceções.
 

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

Confira também

ISequentialStream Interface

IXMLHTTPRequest2Callback