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
| 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 |