Metodo IXMLHTTPRequest2Callback::OnDataAvailable (msxml6.h)

  • Articolo

Si verifica quando un client riceve parte dei dati di risposta HTTP dal server.

Sintassi

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

Parametri

[in, optional] pXHR

Richiesta HTTP iniziale.

[in, optional] pResponseStream

Flusso di risposta ricevuto. Il client può chiamare ISequentialStream::Read per iniziare a elaborare i dati oppure può attendere fino a quando non ha ricevuto la risposta completa. Questo flusso di risposta viene eseguito in un oggetto di sincronizzazione del flusso che impedisce operazioni di lettura e scrittura simultanee, pertanto l'applicazione non deve implementare la sincronizzazione personalizzata.

Valore restituito

Restituisce S_OK sull'esito positivo.

Nota Questa funzione di callback non deve generare eccezioni.
 

Commenti

Quando questa funzione di callback restituisce l'applicazione può iniziare a elaborare i dati dalla risposta HTTP, anche se non ha ancora ricevuto l'intera risposta. Tuttavia, la ricezione viene sospesa per la richiesta fino a quando non viene restituita questa funzione di callback. Inoltre, questo callback può essere richiamato più volte durante una singola richiesta.

Questa funzione di callback non deve essere bloccata e non deve essere effettuata per eseguire operazioni con utilizzo intensivo delle risorse, ad esempio gli aggiornamenti dell'interfaccia utente.

I flussi personalizzati ricevono una chiamata a ISequentialStream::Write prima che OnDataAvailable venga attivata. Il client può elaborare i dati direttamente dalla chiamata di scrittura anziché chiamare ISequentialStream::Read nel flusso personalizzato e può basarsi sulla chiamata di scrittura per indicare che sono disponibili nuovi dati.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP],MSXML 6.0 e versioni successive
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione msxml6.h

Vedi anche

Interfaccia ISequentialStream

IXMLHTTPRequest2Callback