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

Ocorre quando um cliente recebe parte dos dados de resposta HTTP do servidor.

Sintaxe

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

Parâmetros

[in, optional] pXHR

A 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 aguardar até receber a resposta completa. 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 essa função de retorno de chamada retorna, o aplicativo pode começar a processar dados da resposta HTTP, mesmo que ainda não tenha recebido toda a resposta. No entanto, o recebimento é suspenso para a solicitação até que essa função de retorno de chamada retorne. Além disso, esse retorno de chamada pode ser invocado várias vezes durante uma única solicitação.

Essa função de retorno de chamada não deve bloquear e não deve ser feita para executar operações com uso intensivo de recursos, como atualizações de interface do usuário.

Os fluxos personalizados recebem uma chamada para ISequentialStream::Write antes de OnDataAvailable ser acionado. O cliente pode processar dados diretamente da chamada de Gravação em vez de chamar ISequentialStream::Read no fluxo personalizado e pode contar com a chamada De gravação para indicar que novos dados estão disponíveis.

Requisitos

Confira também

ISequentialStream Interface

IXMLHTTPRequest2Callback