IXMLHTTPRequest2Callback::OnDataAvailable-Methode (msxml6.h)
Tritt auf, wenn ein Client einen Teil der HTTP-Antwortdaten vom Server empfängt.
Syntax
HRESULT OnDataAvailable(
[in, optional] IXMLHTTPRequest2 *pXHR,
[in, optional] ISequentialStream *pResponseStream
);
Parameter
[in, optional] pXHR
Die anfängliche HTTP-Anforderung.
[in, optional] pResponseStream
Der empfangene Antwortdatenstrom. Der Client kann ISequentialStream::Read aufrufen, um mit der Verarbeitung der Daten zu beginnen, oder er kann warten, bis er die vollständige Antwort erhalten hat. Dieser Antwortdatenstrom ist 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 diese Rückruffunktion zurückgibt, kann die Anwendung mit der Verarbeitung von Daten aus der HTTP-Antwort beginnen, auch wenn sie noch nicht die gesamte Antwort empfangen hat. Der Empfang wird jedoch für die Anforderung angehalten, bis diese Rückruffunktion zurückgegeben wird. Darüber hinaus kann dieser Rückruf während einer einzelnen Anforderung mehrmals aufgerufen werden.
Diese Rückruffunktion darf nicht blockieren und sollte nicht ausgeführt werden, um ressourcenintensive Vorgänge wie Benutzeroberflächenupdates auszuführen.
Benutzerdefinierte Streams erhalten einen Aufruf von ISequentialStream::Write , bevor OnDataAvailable ausgelöst wird. Der Client kann Daten direkt aus dem Write-Aufruf verarbeiten, anstatt ISequentialStream::Read im benutzerdefinierten Stream aufzurufen, und er kann sich auf den Write-Aufruf verlassen, um anzugeben, dass neue Daten verfügbar sind.
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 |