Partager via


Méthode IXMLHTTPRequest2Callback ::OnResponseReceived (msxml6.h)

Se produit lorsqu’un client a reçu une réponse complète du serveur.

Syntaxe

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

Paramètres

[in, optional] pXHR

Objet de requête HTTP initial

[in, optional] pResponseStream

Flux de réponse reçu. Le client peut appeler ISequentialStream ::Read pour commencer à traiter les données, ou il peut stocker une référence à pResponseStream pour un traitement ultérieur. 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 cet événement se déclenche, l’application peut commencer à traiter les données de la réponse HTTP. Le traitement peut commencer avant que cet événement ne se déclenche si un événement OnDataAvailable antérieur s’est produit.

Sauf si OnError est appelé, l’appel à OnResponseReceived est le rappel final. Le client doit effectuer tout nettoyage requis, y compris libérer des références à l’objet IXMLHTTPRequest2 .

Les flux personnalisés reçoivent un appel à ISequentialStream ::Write spécifiant 0 octet écrit avant le déclenchement d’OnResponseReceived . 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 sans octet pour indiquer que la réponse a été reçue.

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