IXMLHTTPRequest3-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. Wird von der IXMLHTTPRequest2-Schnittstelle abgeleitet.

Hinweis Diese Schnittstelle wird in Windows Phone 8.1 unterstützt.

 

Vererbung

Die IXMLHTTPRequest3-Schnittstelle erbt von IXMLHTTPRequest2. IXMLHTTPRequest3 verfügt auch über folgende Membertypen:

Methoden

Die IXMLHTTPRequest3-Schnittstelle verfügt über diese Methoden.

IXMLHTTPRequest3::SetClientCertificate Legt ein Clientzertifikat fest, das für die Authentifizierung für die in der Open-Methode angegebene URL verwendet werden soll.

Hinweise

Die IXMLHTTPRequest3-Schnittstelle konfiguriert und sendet HTTP-Anforderungen und verwendet Rückrufe, um Benachrichtigungen während der HTTP-Antwortverarbeitung zu empfangen. Die IXMLHTTPRequest3-Schnittstelle ermöglicht apps die Ausführung in einem Multithread-Apartment (MTA), eine Voraussetzung für die Ausführung unter dem Windows-Runtime (WinRT).

Die IXMLHTTPRequest3-Schnittstelle erweitert die IXMLHTTPRequest2-Schnittstelle .

Die IXMLHTTPRequest3 - und IXMLHTTPRequest3Callback-Schnittstellen erweitern die Von den Schnittstellen IXMLHTTPRequest2 und IXMLHTTPRequest2Callback bereitgestellten Features um die folgenden Ergänzungen:

• Ermöglicht das Festlegen eines Clientzertifikats für die HTTPS-Anforderung mit der SetClientCertificate-Methode auf der IXMLHTTPRequest3-Schnittstelle .
• Ermöglicht das Abrufen einer Ausstellerliste zum Filtern berechtigter Clientzertifikate für die nächste HTTP-Anforderung mit der OnClientCertificateRequested-Methode auf der IXMLHTTPRequest3Callback-Schnittstelle .
• Ermöglicht das Ignorieren bestimmter Zertifikatfehler, die andernfalls die HTTPS-Verbindung abgebrochen hätten.
• Ermöglicht das Abrufen von Zertifikatfehlern und der Serverzertifikatkette aus der HTTPS-Antwort mit der OnServerCertificateReceived-Methode auf der IXMLHTTPRequest3Callback-Schnittstelle .

Die SetProperty-Methode für die IXMLHTTPRequest2-Schnittstelle wird auf der IXMLHTTPRequest3-Schnittstelle um neue Eigenschaften erweitert, um neue Szenarien zu unterstützen:

• XHR_PROP_NO_CACHE: Unterdrückt Cache-Lese- und Schreibvorgänge für die HTTP-Anforderung.
• XHR_PROP_EXTENDED_ERROR: Bewirkt, dass der HTTP-Stapel HRESULTS mit dem zugrunde liegenden Win32-Fehlercode für die OnError-Methode im Falle eines Fehlers bereitstellt.
• XHR_PROP_QUERY_STRING_UTF8: Bewirkt, dass die Abfragezeichenfolge in UTF-8 anstelle von ACP für HTTP-Anforderung codiert wird.
• XHR_PROP_IGNORE_CERT_ERRORS: Unterdrückt bestimmte Serverzertifikatfehler.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	msxml6.h

Weitere Informationen

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty