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