IXMLHTTPRequest2::Open-Methode (msxml6.h)
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 |