IXMLHTTPRequest2Callback::OnResponseReceived-Methode (msxml6.h)
Tritt auf, wenn ein Client eine vollständige Antwort vom Server erhalten hat.
Syntax
HRESULT OnResponseReceived(
[in, optional] IXMLHTTPRequest2 *pXHR,
[in, optional] ISequentialStream *pResponseStream
);
Parameter
[in, optional] pXHR
Das anfängliche HTTP-Anforderungsobjekt
[in, optional] pResponseStream
Der empfangene Antwortstream. Der Client kann ISequentialStream::Read aufrufen, um mit der Verarbeitung der Daten zu beginnen, oder er kann einen Verweis auf pResponseStream für die spätere Verarbeitung speichern. Dieser Antwortdatenstrom wird in ein Streamsynchronisierungsobjekt eingeschlossen, das gleichzeitige Lese- und Schreibvorgänge verhindert, sodass die Anwendung keine benutzerdefinierte Synchronisierung implementieren muss.
Rückgabewert
Gibt bei Erfolg S_OK zurück.
Hinweise
Wenn dieses Ereignis ausgelöst wird, kann die Anwendung mit der Verarbeitung von Daten aus der HTTP-Antwort beginnen. Die Verarbeitung kann beginnen, bevor dieses Ereignis ausgelöst wird, wenn ein früheres OnDataAvailable-Ereignis aufgetreten ist.
Sofern OnError nicht aufgerufen wird, ist der Aufruf von OnResponseReceived der letzte Rückruf. Der Client sollte alle erforderlichen Bereinigungen durchführen, einschließlich der Freigabe von Verweisen auf das IXMLHTTPRequest2-Objekt .
Benutzerdefinierte Streams erhalten einen Aufruf von ISequentialStream::Write , der 0 Bytes angibt, die geschrieben wurden, bevor OnResponseReceived ausgelöst wird. Der Client kann Daten direkt aus dem Write-Aufruf verarbeiten, anstatt ISequentialStream::Read für den benutzerdefinierten Stream aufzurufen, und er kann sich auf den Zero-Byte Write-Aufruf verlassen, um anzugeben, dass die Antwort empfangen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps],MSXML 6.0 und höher |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | msxml6.h |