Metodo IXMLHTTPRequest2Callback::OnResponseReceived (msxml6.h)

  • Articolo

Si verifica quando un client ha ricevuto una risposta completa dal server.

Sintassi

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

Parametri

[in, optional] pXHR

Oggetto richiesta HTTP iniziale

[in, optional] pResponseStream

Flusso di risposta ricevuto. Il client può chiamare ISequentialStream::Read per iniziare a elaborare i dati oppure può archiviare un riferimento a pResponseStream per l'elaborazione successiva. 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 questo evento genera l'applicazione può iniziare a elaborare i dati dalla risposta HTTP. L'elaborazione può iniziare prima che questo evento venga generato se si è verificato un evento OnDataAvailable precedente.

A meno che non venga chiamato OnError , la chiamata a OnResponseReceived è il callback finale. Il client deve eseguire qualsiasi pulizia necessaria, incluso il rilascio di riferimenti all'oggetto IXMLHTTPRequest2 .

I flussi personalizzati ricevono una chiamata a ISequentialStream::Write che specifica 0 byte scritti prima che OnResponseReceived venga attivato. 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 zero byte per indicare che la risposta è stata ricevuta.

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