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