IXMLHTTPRequest2 ::Open, méthode (msxml6.h)

Article
02/29/2024

Initialise une requête IXMLHTTPRequest2 et spécifie la méthode, l’URL et les informations d’authentification pour la demande. Après avoir appelé cette méthode, vous devez appeler la méthode Send pour envoyer la requête et les données, le cas échéant, au serveur.

Syntaxe

HRESULT Open(
  [in]           const WCHAR              *pwszMethod,
  [in]           const WCHAR              *pwszUrl,
  [in, optional] IXMLHTTPRequest2Callback *pStatusCallback,
  [in, optional] const WCHAR              *pwszUserName,
  [in, optional] const WCHAR              *pwszPassword,
  [in, optional] const WCHAR              *pwszProxyUserName,
  [in, optional] const WCHAR              *pwszProxyPassword
);

Paramètres

[in] pwszMethod

Méthode HTTP utilisée pour ouvrir la connexion, telle que GET ou POST. Pour XMLHTTP, ce paramètre n’est pas sensible à la casse.

[in] pwszUrl

URL demandée. Il doit s’agir d’une URL absolue, telle que «http://Myserver/Mypath/Myfile.asp" ; ».

[in, optional] pStatusCallback

Interface de rappel implémentée par l’application qui doit recevoir des événements de rappel.

Lorsque la méthode d’envoi réussit, les méthodes de cette interface sont appelées pour traiter la réponse ou d’autres événements.

[in, optional] pwszUserName

Nom de l’utilisateur pour l’authentification. Si ce paramètre est null et que le site nécessite une authentification, les informations d’identification sont gérées par Windows, y compris l’affichage d’une interface utilisateur d’ouverture de session, sauf si elle est désactivée par SetProperty.

[in, optional] pwszPassword

Mot de passe pour l'authentification. Ce paramètre est ignoré si le paramètre pwszUserName est Null ou manquant.

[in, optional] pwszProxyUserName

Nom de l’utilisateur pour l’authentification sur le serveur proxy. Si ce paramètre est une chaîne Null ou vide et que le site nécessite une authentification, les informations d’identification sont gérées par Windows, y compris l’affichage d’une interface utilisateur d’ouverture de session, sauf si elle est désactivée par SetProperty.

[in, optional] pwszProxyPassword

Mot de passe pour l’authentification sur le serveur proxy. Ce paramètre est ignoré si le paramètre pwszProxyUserName est Null ou manquant.

Valeur retournée

Renvoie S_OK en cas de réussite.

Remarques

Bien que cette méthode accepte les informations d’identification transmises via un paramètre, ces informations d’identification ne sont pas envoyées automatiquement au serveur lors de la première demande. Les paramètres pwszUserName et pwszPassword ne sont pas envoyés au serveur, sauf si le serveur demande au client des informations d’identification avec une réponse 401 - Non autorisée.

Exemples

//
// Create and initialize an IXMLHTTPRequest2 object
//
hr = CoCreateInstance(CLSID_FreeThreadedXMLHTTP60,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_PPV_ARGS(&spXHR));

//
//Create and initialize an IXMLHTTPRequest2Callback object
//
hr = MakeAndInitialize<CXMLHttpRequest2Callback>(&spXhrCallback);

hr = spXHR->Open(L"GET",              // Method.
                 pcwszUrl,            // Url.
                 spXhrCallback.Get(), // Callback.
                 NULL,                // Username.
                 NULL,                // Password.
                 NULL,                // Proxy username.
                 NULL);               // Proxy password.

//
//Send the GET request
//
hr = spXHR->Send(NULL, 0);

hr = spXhrCallback->WaitForComplete(&dwStatus);

Pour obtenir des exemples complets, consultez l’exemple GET de requête HTTP XML 2 et l’exemple DE REQUÊTE HTTP XML 2 POST.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP],MSXML 6.0 et versions ultérieures
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msxml6.h

Voir aussi

IXMLHTTPRequest2

IXMLHTTPRequest2Callback, interface

Send, méthode

Partager via