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.
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 |