Interface IWinHttpRequest

L’interface IWinHttpRequest fournit toutes les méthodes non-événement pour Microsoft Windows services HTTP (WinHTTP).

Members

L’interface IWinHttpRequest hérite de l’interface IUnknown . IWinHttpRequest possède également ces types de membres :

• Méthodes
• Propriétés

Méthodes

L’interface IWinHttpRequest a ces méthodes.

Méthode	Description
Abandonner	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.
Envoyer	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, soit un serveur proxy, soit 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 de délai d’attente individuels d’une opération d’envoi/réception, en millisecondes.
WaitForResponse	Attend qu’une méthode Send asynchrone se termine, avec une valeur de délai d’attente facultative, en secondes.

Propriétés

L’interface IWinHttpRequest possède ces propriétés.

Propriété	Type d’accès	Description
Option	Lecture/écriture	Valeur d’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 sous la forme d’un IStream.
ResponseText	Lecture seule	Corps de l’entité de réponse.
État	Lecture seule	Code d’état HTTP de la dernière réponse.
StatusText	Lecture seule	Texte d’état HTTP.

Remarks

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 de CLSID_WinHttpRequest et un ID d’interface de IID_IWinHttpRequest.

Note

Pour Windows XP et Windows 2000, consultez la section Run-Time Configuration requise de la page de démarrage WinHttp.

Requirements

Requirement	Value
Client minimum requis	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
Library	Winhttp.lib
DLL	Winhttp.dll

Voir aussi

IWinHttpRequestEvents

WinHTTP Versions