Interface IXMLHTTPRequest2 (msxml6.h)

Article
03/04/2024

Fournit les méthodes et propriétés nécessaires pour configurer et envoyer des requêtes HTTP et utiliser des rappels pour recevoir des notifications pendant le traitement de la réponse HTTP.

Note Cette interface est prise en charge sur Windows Phone 8.1.

Héritage

L’interface IXMLHTTPRequest2 hérite de l’interface IUnknown. IXMLHTTPRequest2 a également les types de membres suivants :

Méthodes

L’interface IXMLHTTPRequest2 a ces méthodes.


IXMLHTTPRequest2 ::Abort Annule la requête HTTP en cours.
IXMLHTTPRequest2 ::GetAllResponseHeaders Récupère les valeurs de tous les en-têtes de réponse HTTP.
IXMLHTTPRequest2 ::GetCookie Obtient un cookie associé à l’URL spécifiée à partir du fichier jar de cookie HTTP.
IXMLHTTPRequest2 ::GetResponseHeader Récupère la valeur d’un en-tête HTTP à partir des en-têtes de réponse.
IXMLHTTPRequest2 ::Open Initialise une requête IXMLHTTPRequest2 et spécifie la méthode, l’URL et les informations d’authentification pour la demande. Après avoir appelé cette méthode, vous devez appeler la méthode Send pour envoyer la requête et les données, le cas échéant, au serveur.
IXMLHTTPRequest2 ::Send Envoie une requête HTTP au serveur de façon asynchrone. En cas de réussite, les méthodes de l’interface IXMLHTTPRequest2Callback implémentées par l’application sont appelées pour traiter la réponse.
IXMLHTTPRequest2 ::SetCookie Définit un cookie associé à l’URL spécifiée dans le fichier jar de cookie HTTP.
IXMLHTTPRequest2 ::SetCustomResponseStream Fournit un flux personnalisé pour remplacer le flux standard pour la réception d’une réponse HTTP.
IXMLHTTPRequest2 ::SetProperty Définit une propriété sur une requête HTTP sortante.
IXMLHTTPRequest2 ::SetRequestHeader Spécifie le nom d’un en-tête HTTP à envoyer au serveur, ainsi que les en-têtes de requête par défaut.

Remarques

L’interface IXMLHTTPRequest2 est étendue par l’interface IXMLHTTPRequest3. IXMLHTTPRequest3 hérite de toutes les méthodes et propriétés de l’interface IXMLHTTPRequest2.

L’interface IXMLHTTPRequest2 configure et envoie des opérations de requête HTTP et utilise des rappels pour recevoir des notifications pendant le traitement de la réponse. IXMLHTTPRequest2 permet aux applications de s’exécuter dans un multithread (MTA), une exigence pour s’exécuter sous le Windows Runtime (WinRT).

L’interface IXMLHTTPRequest2 prend en charge les fonctionnalités suivantes :

Définissez les propriétés sur les requêtes HTTP sortantes.
Définissez des cookies dans le fichier jar de cookies HTTP à utiliser dans les requêtes HTTP sortantes.
Obtenez des cookies à partir du fichier jar de cookies HTTP.
Traitez les données de réponse HTTP entrantes avant la fin du téléchargement de la réponse HTTP.
Créez des flux personnalisés pour recevoir des réponses HTTP.

IXMLHTTPRequest2 implémente un modèle de rappel pour la gestion des événements. Étant donné que les méthodes IXMLHTTPRequest2 autorisent uniquement les appels de méthode asynchrones, pour recevoir des rappels d’achèvement, une application doit passer un pointeur vers un objet IXMLHTTPRequest2Callback lorsqu’elle appelle la méthode IXMLHTTPRequest2 ::Open pour créer une requête HTTP.

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