IXMLHTTPRequest2::SetProperty-Methode (msxml6.h)

Artikel
02/29/2024

Legt eine Eigenschaft für eine ausgehende HTTP-Anforderung fest.

Syntax

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

Parameter

[in] eProperty

Folgende Werte sind gültig:

Wert	Bedeutung
XHR_PROP_NO_CRED_PROMPT	Unterdrückt automatische Eingabeaufforderungen für Benutzeranmeldeinformationen
XHR_PROP_NO_AUTH	Unterdrückt die Authentifizierung, die der HTTP-Stapel im Auftrag der Anwendung ausführt.
XHR_PROP_TIMEOUT	Legt alle Timeoutwerte auf den von ullValue angegebenen Wert in Millisekunden fest.
XHR_PROP_NO_DEFAULT_HEADERS	Unterdrückt das Hinzufügen von Standardheadern zur HTTP-Anforderung.
XHR_PROP_REPORT_REDIRECT_STATUS	Bewirkt, dass der HTTP-Stapel die OnHeadersAvailable-Methode mit einer Zwischenumleitung status Code aufruft. Die OnHeadersAvailable-Methode wird für zusätzliche Umleitungen und das endgültige Ziel status Code erneut aufgerufen.
XHR_PROP_NO_CACHE	Unterdrückt Cachelese- und -schreibvorgänge für die HTTP-Anforderung. Diese Eigenschaft wird von der IXMLHTTPRequest3-Schnittstelle unterstützt.
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. Diese Eigenschaft wird von der IXMLHTTPRequest3-Schnittstelle unterstützt.
XHR_PROP_QUERY_STRING_UTF8	Bewirkt, dass die Abfragezeichenfolge in UTF-8 anstelle von ACP für die HTTP-Anforderung codiert wird. Diese Eigenschaft wird von der IXMLHTTPRequest3-Schnittstelle unterstützt.
XHR_PROP_IGNORE_CERT_ERRORS	Unterdrückt bestimmte Zertifikatfehler. Diese Eigenschaft wird von der IXMLHTTPRequest3-Schnittstelle unterstützt.

[in] ullValue

Gibt die Anzahl von Millisekunden an, die die Anwendung wartet, bevor die Zeitüberschreitung erfolgt.

Wert	Bedeutung
XHR_PROP_NO_CRED_PROMPT	Dieser Parameter kann einer der Werte aus dem XHR_CRED_PROMPT Enumerationstyp sein, der in der Headerdatei "Msxml6.h " definiert ist. XHR_CRED_PROMPT_ALL , wenn die Anmeldeinformationsaufforderung aktiviert sein soll (Standard). XHR_CRED_PROMPT_NONE , wenn die Anmeldeinformationsaufforderung deaktiviert werden soll. XHR_CRED_PROMPT_PROXY , wenn die Anmeldeinformationen nur für die Proxyauthentifizierung aktiviert werden sollen.
XHR_PROP_NO_AUTH	Dieser Parameter kann einer der Werte aus dem XHR_AUTH Enumerationstyp sein, der in der Headerdatei "Msxml6.h " definiert ist. XHR_AUTH_ALL , wenn die Authentifizierung aktiviert ist (Standard). XHR_AUTH_NONE , wenn die Authentifizierung deaktiviert ist. XHR_AUTH_PROXY , wenn die Authentifizierung nur für die Proxyauthentifizierung aktiviert werden soll.
XHR_PROP_TIMEOUT	Die Anzahl der Millisekunden bis zu 0xFFFFFFFF, die die App wartet, bevor ein Timeout erfolgt.
XHR_PROP_NO_DEFAULT_HEADERS	FALSE(0x0), um das Hinzufügen von Standardheadern (Standard) zu aktivieren. TRUE(0x1), um das Hinzufügen von Standardheadern zu deaktivieren.
XHR_PROP_REPORT_REDIRECT_STATUS	FALSE(0x0), um keine Umleitung status (Standard) zu melden. TRUE(0x1), um Umleitungs-status zu melden.
XHR_PROP_NO_CACHE	FALSE(0x0), um die Zwischenspeicherung zu aktivieren (Standard). TRUE(0x1), um die Zwischenspeicherung zu deaktivieren.
XHR_PROP_EXTENDED_ERROR	FALSE(0x0), um keine erweiterten Fehler bereitzustellen (Standard). TRUE(0x1), um erweiterte Fehler bereitzustellen.
XHR_PROP_QUERY_STRING_UTF8	FALSE(0x0), um die Abfragezeichenfolge nicht in UTF-8 (Standard) zu codieren. TRUE(0x1), um die Abfragezeichenfolge in UTF-8 zu codieren.
XHR_PROP_IGNORE_CERT_ERRORS	FALSE(0x0), um Zertifikatfehler nicht zu ignorieren (Standard). TRUE(0x1), um Zertifikatfehler zu ignorieren.

Rückgabewert

Gibt bei Erfolg S_OK zurück.

Bemerkungen

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

XHR_PROPERTY-Enumeration

Freigeben über