InternetSetCookieExA-Funktion (wininet.h)

Artikel
08/27/2023

Die InternetSetCookieEx-Funktion erstellt ein Cookie mit einem angegebenen Namen, der einer angegebenen URL zugeordnet ist. Diese Funktion unterscheidet sich von der InternetSetCookie-Funktion , indem sie Cookies von Drittanbietern erstellen kann.

Syntax

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Parameter

[in] lpszUrl

Zeiger auf eine NULL-Zeichenfolge, die die URL enthält, für die das Cookie festgelegt werden soll.

Wenn dieser Zeiger NULL ist, schlägt InternetSetCookieEx mit einem ERROR_INVALID_PARAMETER Fehler fehl.

[in] lpszCookieName

Zeiger auf eine null-beendete Zeichenfolge, die den Namen enthält, der diesem Cookie zugeordnet werden soll. Wenn dieser Zeiger NULL ist, ist dem Cookie kein Name zugeordnet.

[in] lpszCookieData

Zeiger auf eine NULL-Zeichenfolge, die die Daten enthält, die dem neuen Cookie zugeordnet werden sollen.

Wenn dieser Zeiger NULL ist, schlägt InternetSetCookieEx mit einem ERROR_INVALID_PARAMETER Fehler fehl.

[in] dwFlags

Flags, die steuern, wie die Funktion Cookiedaten abruft:

Wert	Bedeutung
INTERNET_COOKIE_EVALUATE_P3P	Wenn dieses Flag festgelegt ist und der dwReserved-Parameter nicht NULL ist, wird der dwReserved-Parameter in einen LPCTSTR umgewandelt, der auf einen P3P-Header (Platform-for-Privacy-Protection) für das betreffende Cookie verweist.
INTERNET_COOKIE_HTTPONLY	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 siteübergreifende Skriptangriffe werden. Es ist absolut unerlässlich, dass Sie dieses Flag nur verwenden, wenn sie garantieren können, dass Sie niemals zulassen, dass Drittanbietercode ein Cookie mithilfe dieses Flags über einen von Ihnen bereitgestellten Erweiterbarkeitsmechanismus festlegen kann. Version: Erfordert Internet Explorer 8.0 oder höher.
INTERNET_COOKIE_THIRD_PARTY	Gibt an, dass es sich bei dem gesetzten Cookie um ein Drittanbietercookies handelt.
INTERNET_FLAG_RESTRICTED_ZONE	Gibt an, dass das gesetzte Cookie einer nicht vertrauenswürdigen Website zugeordnet ist.

[in] dwReserved

NULL, oder enthält einen Zeiger auf einen P3P-Header (Platform-for-Privacy-Protection), der dem Cookie zugeordnet werden soll.

Rückgabewert

Gibt bei erfolgreicher Ausführung ein Element der InternetCookieState-Enumeration oder FALSE zurück, wenn die Funktion fehlschlägt. Wenn bei einem Fehler ein Aufruf von GetLastError ERROR_NOT_ENOUGH_MEMORY zurückgibt, war nicht genügend Systemspeicher verfügbar.

Hinweise

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

Hinweis

Der wininet.h-Header definiert InternetSetCookieEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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