IXMLHTTPRequest2::Open-Methode (msxml6.h)

  • Artikel

Initialisiert eine IXMLHTTPRequest2-Anforderung und gibt die Methode, die URL und die Authentifizierungsinformationen für die Anforderung an. Nachdem Sie diese Methode aufgerufen haben, müssen Sie die Send-Methode aufrufen, um die Anforderung und ggf. die Daten an den Server zu senden.

Syntax

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
);

Parameter

[in] pwszMethod

Die ZUM Öffnen der Verbindung verwendete HTTP-Methode, z. B. GET oder POST. Bei XMLHTTP wird die Groß- und Kleinschreibung bei diesem Parameter nicht beachtet.

[in] pwszUrl

Die angeforderte URL. Dies muss eine absolute URL sein, z. B. "http://Myserver/Mypath/Myfile.asp".

[in, optional] pStatusCallback

Eine von der App implementierte Rückrufschnittstelle, die Rückrufereignisse empfangen soll.

Wenn die Send-Methode erfolgreich ist, werden die Methoden auf dieser Schnittstelle aufgerufen, um die Antwort oder andere Ereignisse zu verarbeiten.

[in, optional] pwszUserName

Der Name des Benutzers für die Authentifizierung. Wenn dieser Parameter null ist und die Website eine Authentifizierung erfordert, werden die Anmeldeinformationen von Windows verwaltet, einschließlich der Anzeige einer Anmeldebenutzeroberfläche, es sei denn, dies wird von SetProperty deaktiviert.

[in, optional] pwszPassword

Das Kennwort für die Authentifizierung. Dieser Parameter wird ignoriert, wenn der pwszUserName-Parameter NULL ist oder fehlt.

[in, optional] pwszProxyUserName

Der Name des Benutzers für die Authentifizierung auf dem Proxyserver. Wenn es sich bei diesem Parameter um eine NULL- oder leere Zeichenfolge handelt und die Website eine Authentifizierung erfordert, werden die Anmeldeinformationen von Windows verwaltet, einschließlich der Anzeige einer Anmeldebenutzeroberfläche, es sei denn, dies wird von SetProperty deaktiviert.

[in, optional] pwszProxyPassword

Das Kennwort für die Authentifizierung auf dem Proxyserver. Dieser Parameter wird ignoriert, wenn der pwszProxyUserName-Parameter NULL ist oder fehlt.

Rückgabewert

Gibt bei Erfolg S_OK zurück.

Bemerkungen

Obwohl diese Methode Anmeldeinformationen akzeptiert, die über den Parameter übergeben werden, werden diese Anmeldeinformationen nicht automatisch bei der ersten Anforderung an den Server gesendet. Die Parameter pwszUserName und pwszPassword werden nicht an den Server gesendet, es sei denn, der Server fordert den Client mit der Antwort 401 – Nicht autorisiert um Anmeldeinformationen heraus.

Beispiele

//
// 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);

Die vollständigen Beispiele finden Sie im XML HTTP Request 2 GET-Beispiel und im POST-Beispiel für XML-HTTP-Anforderung 2.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps],MSXML 6.0 und höher
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile msxml6.h

Weitere Informationen

IXMLHTTPRequest2

IXMLHTTPRequest2Callback-Schnittstelle

Send-Methode