IXMLHTTPRequest2-Schnittstelle (msxml6.h)
Stellt die Methoden und Eigenschaften bereit, die zum Konfigurieren und Senden von HTTP-Anforderungen und zum Empfangen von Benachrichtigungen während der HTTP-Antwortverarbeitung erforderlich sind.
Vererbung
Die IXMLHTTPRequest2-Schnittstelle erbt von der IUnknown-Schnittstelle . IXMLHTTPRequest2 verfügt auch über folgende Membertypen:
Methoden
Die IXMLHTTPRequest2-Schnittstelle verfügt über diese Methoden.
|
IXMLHTTPRequest2::Abort Bricht die aktuelle HTTP-Anforderung ab. |
|
IXMLHTTPRequest2::GetAllResponseHeaders Ruft die Werte aller HTTP-Antwortheader ab. |
|
IXMLHTTPRequest2::GetCookie Ruft ein Cookie ab, das der angegebenen URL aus der HTTP-Cookie-JAR zugeordnet ist. |
|
IXMLHTTPRequest2::GetResponseHeader Ruft den Wert eines HTTP-Headers aus den Antwortheadern ab. |
|
IXMLHTTPRequest2::Open Initialisiert eine IXMLHTTPRequest2-Anforderung und gibt die Methoden-, URL- und 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. |
|
IXMLHTTPRequest2::Send Sendet asynchron eine HTTP-Anforderung an den Server. Bei Erfolg werden Methoden auf der von der App implementierten IXMLHTTPRequest2Callback-Schnittstelle aufgerufen, um die Antwort zu verarbeiten. |
|
IXMLHTTPRequest2::SetCookie Legt ein Cookie fest, das der angegebenen URL in der HTTP-Cookie-JAR zugeordnet ist. |
|
IXMLHTTPRequest2::SetCustomResponseStream Stellt einen benutzerdefinierten Datenstrom bereit, um den Standarddatenstrom für den Empfang einer HTTP-Antwort zu ersetzen. |
|
IXMLHTTPRequest2::SetProperty Legt eine Eigenschaft für eine ausgehende HTTP-Anforderung fest. |
|
IXMLHTTPRequest2::SetRequestHeader Gibt den Namen eines HTTP-Headers an, der zusammen mit den Standardanforderungsheadern an den Server gesendet werden soll. |
Hinweise
Die IXMLHTTPRequest2-Schnittstelle wird um die IXMLHTTPRequest3-Schnittstelle erweitert. IXMLHTTPRequest3 erbt alle Methoden und Eigenschaften der IXMLHTTPRequest2-Schnittstelle.
Die IXMLHTTPRequest2-Schnittstelle konfiguriert und sendet HTTP-Anforderungsvorgänge und verwendet Rückrufe, um Benachrichtigungen während der Antwortverarbeitung zu empfangen. IXMLHTTPRequest2 ermöglicht die Ausführung von Anwendungen in einem Multithread-Apartment (MTA), eine Voraussetzung für die Ausführung unter dem Windows-Runtime (WinRT).
Die IXMLHTTPRequest2-Schnittstelle unterstützt die folgenden Features:
- Legen Sie Eigenschaften für ausgehende HTTP-Anforderungen fest.
- Legen Sie Cookies in der JAR-Datei für HTTP-Cookies für die Verwendung in ausgehenden HTTP-Anforderungen fest.
- Rufen Sie Cookies aus der HTTP-Cookie-JAR-Datei ab.
- Verarbeiten Sie eingehende HTTP-Antwortdaten, bevor der Download der HTTP-Antwort abgeschlossen ist.
- Erstellen Sie benutzerdefinierte Datenströme, um HTTP-Antworten zu empfangen.
IXMLHTTPRequest2 implementiert ein Rückrufmodell für die Ereignisbehandlung. Da IXMLHTTPRequest2-Methoden nur asynchrone Methodenaufrufe zulassen, muss eine Anwendung zum Empfangen von Abschlussrückrufen einen Zeiger auf ein IXMLHTTPRequest2Callback-Objekt übergeben, wenn sie die IXMLHTTPRequest2::Open-Methode aufruft, um eine HTTP-Anforderung zu erstellen.
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
Schnellstart: Herstellen einer Verbindung mithilfe einer XML-HTTP-Anforderung (IXHR2)