Objet WinHttpRequest

Cette rubrique fournit des informations sur l’utilisation de l’objet COM WinHTTP WinHttpRequest avec des langages de script. Pour plus d’informations, notamment 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 a les types de membres suivants :

• Événements
• Méthodes
• Propriétés

Événements

L’objet WinHttpRequest contient ces événements.

Événement	Description
OnError	Se produit en cas d’erreur d’exécution 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 possède 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 d’origine ou 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 individuels du délai d’attente d’une opération d’envoi/réception.
WaitForResponse	Spécifie le temps d’attente, en secondes, pour qu’une méthode Send 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 de l’entité de réponse sous la forme d’un tableau d’octets non signés.
ResponseStream	Lecture seule	Récupère le corps de l’entité de réponse sous la forme d’un IStream.
ResponseText	Lecture seule	Récupère le corps de l’entité de réponse sous forme de texte.
Statut	Lecture seule	Récupère le code status HTTP de la dernière réponse.
StatusText	Lecture seule	Récupère le texte status HTTP.

Notes

L’objet WinHttpRequest utilise l’interface IErrorInfo pour fournir des 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 nombre d’erreur correspondent aux valeurs trouvées dans messages d’erreur.

Notes

Pour Windows XP et Windows 2000, consultez Conditions requises pour l’exécution.

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

WinHTTP Versions