Partager via


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

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