InternetSetCookieEx2-Funktion (wininet.h)
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 |