Freigeben über

XHR_COOKIE-Struktur (msxml6.h)

  • Artikel

Definiert ein Cookie, das Sie der HTTP-Cookie-JAR hinzufügen können, indem Sie die SetCookie-Methode aufrufen oder durch Aufrufen der GetCookie-Methode aus der HTTP-Cookie-JAR abrufen.

Syntax

typedef struct tagXHR_COOKIE {
  WCHAR    *pwszUrl;
  WCHAR    *pwszName;
  WCHAR    *pwszValue;
  WCHAR    *pwszP3PPolicy;
  FILETIME ftExpires;
  DWORD    dwFlags;
} XHR_COOKIE;

Member

pwszUrl

Eine NULL-Zeichenfolge, die die URL im Cookie angibt.

pwszName

Eine NULL-endende Zeichenfolge, die den Namen im Cookie angibt.

pwszValue

Eine NULL-endende Zeichenfolge, die den Wert im Cookie angibt.

pwszP3PPolicy

Eine Zeichenfolge mit NULL-Beendigung, die die Benutzerrichtlinie im Cookie angibt.

ftExpires

Eine Zeichenfolge mit NULL-Beendigung, die das Datum und die Uhrzeit angibt, an dem das Cookie abläuft.

dwFlags

Ein Satz von Bitflags, der eigenschaften des Cookies angibt.

Dieser Member kann einer der Werte aus dem XHR_COOKIE_FLAG Enumerationstyp sein, der in der Msxml6.h-Headerdatei definiert ist.

Wert Bedeutung
XHR_COOKIE_IS_SECURE
0x1
XHR_COOKIE_IS_SESSION
0x2
 Das Cookie ist ein Sitzungscookies und kein persistentes Cookie.
XHR_COOKIE_THIRD_PARTY
0x10
 Gibt an, dass es sich bei dem zu setzenden Cookie um ein Cookie eines Drittanbieters handelt.
XHR_COOKIE_PROMPT_REQUIRED
0x20
XHR_COOKIE_EVALUATE_P3P
0x40
 Wenn dieses Flag festgelegt ist, verweist das pwszP3PPolicy-Member auf einen P3P-Header (Platform-for-Privacy-Protection) für das betreffende Cookie.
XHR_COOKIE_APPLY_P3P
0x80
XHR_COOKIE_APPLY_P3P
0x100
XHR_COOKIE_IS_RESTRICTED
0x200
 Gibt an, dass das gesetzte Cookie einer nicht vertrauenswürdigen Website zugeordnet ist.
XHR_COOKIE_IE6
0x400
XHR_COOKIE_IS_LEGACY
0x800
XHR_COOKIE_NON_SCRIPT
0x1000
XHR_COOKIE_HTTPONLY
0x2000
 Ermöglicht das Abrufen von Cookies, die als "HTTPOnly" gekennzeichnet sind.

Verwenden Sie dieses Flag nicht, wenn Sie eine skriptfähige Schnittstelle verfügbar machen, da dies Auswirkungen auf die Sicherheit hat. Wenn Sie eine skriptfähige Schnittstelle verfügbar machen, können Sie zu einem Angriffsvektor für websiteübergreifende Skriptangriffe werden. Es ist zwingend erforderlich, dass Sie dieses Flag nur verwenden, wenn sie garantieren können, dass Sie drittanbietercode niemals zulassen, ein Cookie mithilfe dieses Flags über einen von Ihnen bereitgestellten Erweiterbarkeitsmechanismus zu setzen.

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]
Kopfzeile msxml6.h

Weitere Informationen

IXMLHTTPRequest2-Schnittstelle

SetCookie-Methode

SetProperty-Methode