IXMLHTTPRequest2::SetProperty-Methode (msxml6.h)

  • Artikel

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

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

Öffnen

XHR_PROPERTY-Enumeration