Interface IWinHttpRequest

L’interface IWinHttpRequest fournit toutes les méthodes autres que les événements pour Microsoft Windows HTTP Services (WinHTTP).

Membres

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

• Méthodes
• Propriétés

Méthodes

L’interface IWinHttpRequest a ces méthodes.

Méthode	Description
Abandon	Abandonne une méthode WinHTTPSend .
GetAllResponseHeaders	Récupère tous les en-têtes de réponse HTTP.
GetResponseHeader	Récupère les en-têtes de réponse HTTP.
Ouvrir	Ouvre une connexion HTTP à une ressource HTTP.
Envoi	Envoie une requête HTTP à un serveur HTTP.
SetAutoLogonPolicy	Définit la stratégie d’ouverture de session automatique actuelle.
SetClientCertificate	Sélectionne un certificat client à envoyer à un serveur HTTPS (Secure Hypertext Transfer Protocol).
SetCredentials	Définit les informations d’identification à utiliser avec un serveur HTTP, un serveur proxy ou un serveur d’origine.
SetProxy	Définit les informations du serveur proxy.
SetRequestHeader	Ajoute, modifie ou supprime un en-tête de requête HTTP.
SetTimeouts	Spécifie les composants individuels du délai d’attente d’une opération d’envoi/réception, en millisecondes.
WaitForResponse	Attend la fin d’une méthode Send asynchrone, avec une valeur de délai d’attente facultative, en secondes.

Propriétés

L’interface IWinHttpRequest a ces propriétés.

Propriété	Type d’accès	Description
Option	Lecture/écriture	Valeur de l’option WinHTTP.
ResponseBody	Lecture seule	Corps de l’entité de réponse sous la forme d’un tableau d’octets non signés.
ResponseStream	Lecture seule	Corps de l’entité de réponse en tant que IStream.
ResponseText	Lecture seule	Corps de l’entité de réponse.
Statut	Lecture seule	Le code HTTP status de la dernière réponse.
StatusText	Lecture seule	Texte status HTTP.

Notes

L’interface IWinHttpRequest définie dans httprequest.idl est implémentée par une classe avec l’id de CLSID_WinHttpRequest. Une application obtient cette interface en appelant CoCreateInstance avec un ID de classe CLSID_WinHttpRequest et un ID d’interface de IID_IWinHttpRequest.

Notes

Pour Windows XP et Windows 2000, consultez la section Conditions requises pour l’exécution de la page de démarrage WinHttp.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Composant redistribuable	WinHTTP 5.0 et Internet Explorer 5.01 ou version ultérieure sur Windows XP et Windows 2000.
IDL	HttpRequest.idl
Bibliothèque	Winhttp.lib
DLL	Winhttp.dll

Voir aussi

IWinHttpRequestEvents

WinHTTP Versions