IXMLHTTPRequest2Callback ::OnDataAvailable, méthode (msxml6.h)
Se produit lorsqu’un client reçoit une partie des données de réponse HTTP du serveur.
Syntaxe
HRESULT OnDataAvailable(
[in, optional] IXMLHTTPRequest2 *pXHR,
[in, optional] ISequentialStream *pResponseStream
);
Paramètres
[in, optional] pXHR
Requête HTTP initiale.
[in, optional] pResponseStream
Flux de réponse reçu. Le client peut appeler ISequentialStream ::Read pour commencer à traiter les données, ou attendre qu’il ait reçu la réponse complète. Ce flux de réponse est encapsulé dans un objet de synchronisation de flux qui empêche les opérations de lecture et d’écriture simultanées, de sorte que l’application n’a pas besoin d’implémenter la synchronisation personnalisée.
Valeur retournée
Renvoie S_OK en cas de réussite.
Remarques
Lorsque cette fonction de rappel retourne, l’application peut commencer à traiter les données de la réponse HTTP, même si elle n’a pas encore reçu la réponse entière. Toutefois, la réception est suspendue pour la requête jusqu’à ce que cette fonction de rappel soit retournée. En outre, ce rappel peut être appelé plusieurs fois au cours d’une seule requête.
Cette fonction de rappel ne doit pas bloquer et ne doit pas être effectuée pour effectuer des opérations nécessitant beaucoup de ressources, telles que les mises à jour de l’interface utilisateur.
Les flux personnalisés reçoivent un appel à ISequentialStream ::Write avant qu’OnDataAvailable soit déclenché. Le client peut traiter des données directement à partir de l’appel d’écriture au lieu d’appeler ISequentialStream ::Read sur le flux personnalisé, et il peut s’appuyer sur l’appel d’écriture pour indiquer que de nouvelles données sont disponibles.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau | Applications UWP],MSXML 6.0 et versions ultérieures |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | msxml6.h |