InternetGetCookieEx2-Funktion (wininet.h)

Artikel
03/04/2024

Ruft ein oder mehrere Cookies ab, die der angegebenen URL zugeordnet sind.

Syntax

DWORD InternetGetCookieEx2(
  PCWSTR           pcwszUrl,
  PCWSTR           pcwszCookieName,
  DWORD            dwFlags,
  INTERNET_COOKIE2 **ppCookies,
  PDWORD           pdwCookieCount
);

Parameter

pcwszUrl

Die URL, für die Cookies abgerufen werden sollen.

pcwszCookieName

Der Name des abzurufenden Cookies. Kann NULL sein.

dwFlags

Flags des abzurufenden Cookies. Die folgenden Flags sind verfügbar.

Wert	Bedeutung
INTERNET_COOKIE_THIRD_PARTY	Rufen Sie Cookies als Drittanbieter ab, sodass nur Erstanbieter-Cookies ausgeschlossen werden.
INTERNET_COOKIE_NON_SCRIPT	Geben Sie an, dass diese Abfrage nicht über JavaScript ausgelöst wurde, sodass nur HTTP-Cookies abgerufen werden können.
INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE	Rufen Sie Cookies ab, als ob sie sich in einem websiteübergreifenden Kontext befinden, mit Ausnahme von Cookies, deren SameSite-Eigenschaft festgelegt ist.
INTERNET_FLAG_RESTRICTED_ZONE	Nur Cookies abrufen, die zulässig wären, wenn die angegebene URL nicht vertrauenswürdig wäre; das heißt, wenn es zur URLZONE_UNTRUSTED Zone gehörte.

ppCookies

Zeiger, der ein Array von INTERNET_COOKIE2 Strukturen empfängt. Das zurückgegebene Array muss von InternetFreeCookies freigegeben werden.

pdwCookieCount

Zeiger auf ein DWORD, das die Anzahl der Strukturen im Array empfängt.

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

Anforderung	Wert
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