InternetSetCookieExA-Funktion (wininet.h)

Artikel
11/20/2024

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 können.

Syntax

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

Parameter

[in] lpszUrl

Zeigen Sie auf eine NULL--terminated-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

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

[in] lpszCookieData

Zeiger auf eine null-terminated string that contains the data to be associated with the new cookie.

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 eine LPCTSTR, die auf einen Platform-for-Privacy-Protection (P3P)-Header für das betreffende Cookie verweist, umwandeln.
INTERNET_COOKIE_HTTPONLY	Ermöglicht den Abruf von Cookies, die als "HTTPOnly" gekennzeichnet sind. Verwenden Sie dieses Flag nicht, wenn Sie eine skriptfähige Schnittstelle verfügbar machen, da dies Sicherheitsauswirkungen hat. Wenn Sie eine skriptfähige Schnittstelle verfügbar machen, können Sie zu einem Angriffsvektor für websiteübergreifende Skriptingangriffe werden. Es ist völlig zwingend erforderlich, dass Sie dieses Flag nur verwenden, wenn sie garantieren können, dass Sie niemals zulassen, dass Drittanbietercode mithilfe dieses Flags durch einen von Ihnen bereitgestellten Erweiterungsmechanismus ein Cookie festlegen kann. Version: Erfordert Internet Explorer 8.0 oder höher.
INTERNET_COOKIE_THIRD_PARTY	Gibt an, dass das gesetzte Cookie ein Cookie eines Drittanbieters ist.
INTERNET_FLAG_RESTRICTED_ZONE	Gibt an, dass das festgelegte Cookie einer nicht vertrauenswürdigen Website zugeordnet ist.

[in] dwReserved

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

Rückgabewert

Gibt ein Element der InternetCookieState Enumeration zurück, wenn dies erfolgreich ist, oder FALSE, wenn die Funktion fehlschlägt. Wenn beim Fehler ein Aufruf von GetLastError ERROR_NOT_ENOUGH_MEMORY zurückgegeben wird, war nicht genügend Systemspeicher verfügbar.

Bemerkungen

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

Anmerkung

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wininet.h
Library	Wininet.lib
DLL-	Wininet.dll