InternetSetCookieEx2-Funktion (wininet.h)

Artikel
08/27/2023

Erstellt ein Cookie, das der angegebenen URL zugeordnet ist.

Syntax

DWORD InternetSetCookieEx2(
  PCWSTR                 pcwszUrl,
  const INTERNET_COOKIE2 *pCookie,
  PCWSTR                 pcwszP3PPolicy,
  DWORD                  dwFlags,
  PDWORD                 pdwCookieState
);

Parameter

pcwszUrl

Die URL, für die das Cookie festgelegt werden soll.

pCookie

Zeiger auf eine INTERNET_COOKIE2-Struktur , die die Cookiedaten enthält.

pcwszP3PPolicy

Zeichenfolge, die die P3P-Richtlinie (Platform-for-Privacy-Protection) für das Cookie enthält. Kann NULL sein.

dwFlags

Flags für das festzulegende Cookie. Die folgenden Flags sind verfügbar.

Wert	Bedeutung
INTERNET_COOKIE_THIRD_PARTY	Legen Sie dieses Cookie in einem Drittanbieterkontext fest.
INTERNET_COOKIE_PROMPT_REQUIRED	Zeigen Sie eine Benutzeroberflächenaufforderung an, um dieses Cookie zu akzeptieren oder abzulehnen.
INTERNET_COOKIE_EVALUATE_P3P	Werten Sie die bereitgestellte P3P-Richtlinie für dieses Cookie aus. Dadurch wird die Standardrichtlinie ausgewertet, wenn pcwszP3PPolicy NULL ist.
INTERNET_COOKIE_NON_SCRIPT	Geben Sie an, dass dieses Cookie nicht über JavaScript festgelegt wird, sodass nur HTTP-Cookies gesetzt werden können.
INTERNET_COOKIE_APPLY_HOST_ONLY	Wenden Sie die richtlinie nur host-only auf dieses Cookie an. Wenn das Domänenattribute nicht festgelegt ist, wird dieses Cookie nur als Host gekennzeichnet.

pdwCookieState

Zeiger auf ein DWORD, das das Ergebnis des Setzens des Cookies empfängt. Eine Liste der möglichen Werte finden Sie unter InternetCookieState.

Rückgabewert

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder einen Systemfehlercode zurück.

Hinweise

Hinweis

WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Kopfzeile	wininet.h
Bibliothek	Wininet.lib
DLL	Wininet.dll