IXMLHTTPRequest2::SetCookie-Methode (msxml6.h)

Artikel
02/29/2024

Legt ein Cookie fest, das der angegebenen URL in der HTTP-Cookie-JAR zugeordnet ist.

Syntax

HRESULT SetCookie(
  const XHR_COOKIE *pCookie,
  DWORD            *pdwCookieState
);

Parameter

pCookie

Ein Zeiger auf eine XHR_COOKIE Struktur, die das Cookie und die Eigenschaften des Cookies angibt, die der angegebenen URL zugeordnet werden sollen.

pdwCookieState

Ein Zeiger auf einen Wert, der den Cookiestatus angibt, wenn der Aufruf erfolgreich abgeschlossen wird.

Dieser Parameter kann einer der Werte aus dem XHR_COOKIE_STATE Enumerationstyp sein, der in der Headerdatei "Msxml6.h " definiert ist.

Wert	Bedeutung
XHR_COOKIE_STATE_UNKNOWN 0	Reserviert.
XHR_COOKIE_STATE_ACCEPT 1	Das Cookie wurde akzeptiert.
XHR_COOKIE_STATE_PROMPT 2	Der Benutzer wird aufgefordert, das Cookie zu akzeptieren oder abzulehnen.
XHR_COOKIE_STATE_LEASH 3	Das Cookie wird nur im Erstanbieterkontext akzeptiert.
XHR_COOKIE_STATE_DOWNGRADE 4	Das Cookie wurde akzeptiert und wurde zu Sitzungscookies.
XHR_COOKIE_STATE_REJECT 5	Das Cookie wurde abgelehnt.

Rückgabewert

Gibt bei Erfolg S_OK zurück.

Bemerkungen

Die SetCookie-Methode hat ein anderes Verhalten für Windows Store-Apps und Windows-Desktopanwendungen.

Bei Verwendung in einer Windows Store-App legt die SetCookie-Methode das Cookie standardmäßig als persistentes Cookie in der Windows Store-App fest. Wenn für den dwFlags-Member des XHR_COOKIE das flag XHR_COOKIE_IS_SESSION festgelegt ist, wird das Cookie nur für die aktuelle Sitzung der App festgelegt.

Bei Verwendung in einer Windows-Desktopanwendung legt die SetCookie-Methode standardmäßig ein persistentes Cookie fest, das systemweit ist und von allen Windows-Desktopanwendungen freigegeben wird. Wenn für das dwFlags-Element der XHR_COOKIE das flag XHR_COOKIE_IS_SESSION festgelegt ist, wird das Cookie nur für die aktuelle Sitzung der Windows-Desktopanwendung festgelegt.

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