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 |
|
| Bibliothèque |
|
| DLL |
|