IXMLHTTPRequest2Callback ::OnDataAvailable, méthode (msxml6.h)

  • Article

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.

Note Cette fonction de rappel ne doit pas lever d’exceptions.
 

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

Voir aussi

ISequentialStream, interface

IXMLHTTPRequest2Callback