Objet WinHttpRequest

Cette rubrique fournit des informations sur l’utilisation de l’objet WinHttpRequest com WinHTTP avec les langages de script. Pour plus d’informations, y compris l’API C++ (WinHTTP), consultez à propos de WinHTTP. Pour une comparaison de ces interfaces, consultez choix d’une interface WinHTTP .

Exemple

// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
 IWinHttpRequest *  pIWinHttpRequest = NULL;
 \\..
    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }

Exemples de code tirés de la propriété IWinHttpRequest :: Status.

Membres

L’objet WinHttpRequest possède les types de membres suivants :

Événements

L’objet WinHttpRequest contient ces événements.

Événement Description
OnError Se produit lorsqu’une erreur d’exécution se produit dans l’application.
OnResponseDataAvailable Se produit lorsque des données sont disponibles à partir de la réponse.
OnResponseFinished Se produit lorsque les données de réponse sont terminées.
OnResponseStart Se produit lorsque les données de réponse commencent à être reçues.

Méthodes

L’objet WinHttpRequest a ces méthodes.

Méthode Description
Arrêté Abandonne une méthode d' envoi WinHTTP .
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 automatiqueactuelle.
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, qu’il s’agisse d’un serveur d’origine ou d’un serveur proxy.
SetProxy Définit les informations du serveur proxy.
SetRequestHeader Ajoute, modifie ou supprime un en-tête de requête HTTP.
SetTimeouts Spécifie, en millisecondes, les composants de délai d’attente individuels d’une opération d’envoi/réception.
WaitForResponse Spécifie le temps d’attente, en secondes, pour qu’une méthode d' envoi asynchrone se termine, avec une valeur de délai d’attente facultative.

Propriétés

L’objet WinHttpRequest a ces propriétés.

Propriété Type d’accès Description
Option
Lecture/écriture
Définit ou récupère une valeur d’option WinHTTP.
ResponseBody
Lecture seule
Récupère le corps d’entité de réponse sous la forme d’un tableau d’octets non signés.
ResponseStream
Lecture seule
Récupère le corps d’entité de réponse en tant qu' IStream.
ResponseText
Lecture seule
Récupère le corps d’entité de réponse sous forme de texte.
État
Lecture seule
Récupère le code d’état HTTP de la dernière réponse.
StatusText
Lecture seule
Récupère le texte d’état HTTP.

Remarques

L’objet WinHttpRequest utilise l’interface IErrorInfo pour fournir les données d’erreur. une description et une valeur d’erreur numérique peuvent être obtenues avec l’objet Err dans microsoft Visual Basic scripting Edition (VBScript) et l’objet error dans microsoft JScript. Les 16 bits inférieurs d’un numéro d’erreur correspondent aux valeurs figurant dans les messages d’erreur.

Notes

pour plus d’Windows XP et Windows 2000, consultez configuration requisepour l’exécution.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows XP, Windows 2000 Professional avec les [ applications de bureau SP3 uniquement]
Serveur minimal pris en charge
Windows server 2003, Windows 2000 server avec des [ applications de bureau SP3 uniquement]
Composant redistribuable
WinHTTP 5,0 et Internet Explorer 5,01 ou version ultérieure sur Windows XP et Windows 2000.
MIDL
HttpRequest. idl
Bibliothèque
WinHTTP. lib
DLL
Winhttp.dll

Voir aussi

Versions de WinHTTP