InternetGetCookieExW-Funktion (wininet.h)

2024-11-20

Die InternetGetCookieEx Funktion ruft Daten ab, die in Cookies gespeichert sind, die einer angegebenen URL zugeordnet sind. Im Gegensatz zu InternetGetCookie-können InternetGetCookieEx- verwendet werden, um Daten einzuschränken, die auf einen einzelnen Cookienamen abgerufen werden, oder anhand einer Richtlinie, die nicht vertrauenswürdigen Websites oder Cookies von Drittanbietern zugeordnet sind.

Syntax

BOOL InternetGetCookieExW(
  [in]                LPCWSTR lpszUrl,
  [in]                LPCWSTR lpszCookieName,
  [in, out, optional] LPWSTR  lpszCookieData,
  [in, out]           LPDWORD lpdwSize,
  [in]                DWORD   dwFlags,
  [in]                LPVOID  lpReserved
);

Parameter

[in] lpszUrl

Ein Zeiger auf eine null-terminated string that contains the URL with which the cookie to retrieve is associated. Dieser Parameter kann nicht NULL- oder InternetGetCookieEx fehlschlägt und einen ERROR_INVALID_PARAMETER Fehler zurückgibt.

[in] lpszCookieName

Ein Zeiger auf eine NULL--terminated-Zeichenfolge, die den Namen des abzurufenden Cookies enthält. Bei diesem Namen wird die Groß-/Kleinschreibung beachtet.

[in, out, optional] lpszCookieData

Ein Zeiger auf einen Puffer zum Empfangen der Cookiedaten.

[in, out] lpdwSize

Ein Zeiger auf eine DWORD-Variable.

Bei der Eingabe muss die Variable die Größe des Puffers enthalten, auf den der pchCookieData-Parameter verweist.

Wenn die Funktion erfolgreich ist, enthält diese Variable die Anzahl der TCHARs von Cookiedaten, die in den Puffer kopiert wurden. Wenn NULL- als lpszCookieData Parameter übergeben wurde oder wenn die Funktion mit einem Fehler von ERROR_INSUFFICIENT_BUFFERfehlschlägt, enthält die Variable die Größe des Puffers, der zum Empfangen der Cookiedaten erforderlich ist.

Dieser Parameter kann nicht NULL- oder InternetGetCookieEx fehlschlägt und einen ERROR_INVALID_PARAMETER Fehler zurückgibt.

[in] dwFlags

Ein Kennzeichen, das steuert, wie die Funktion Cookiedaten abruft. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
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. Es ist zwingend erforderlich, dieses Flag nur zu verwenden, wenn Sie garantieren können, dass Sie das Cookie niemals über einen von Ihnen bereitgestellten Erweiterungsmechanismus dem Drittanbietercode zur Verfügung stellen. Version: Erfordert Internet Explorer 8.0 oder höher.
INTERNET_COOKIE_THIRD_PARTY	Ruft nur Cookies von Drittanbietern ab, wenn die Richtlinie explizit zulässt, dass alle Cookies für die angegebene URL abgerufen werden.
INTERNET_FLAG_RESTRICTED_ZONE	Ruft nur Cookies ab, die zulässig wären, wenn die angegebene URL nicht vertrauenswürdig wäre; d. h., wenn sie zur zone URLZONE_UNTRUSTED gehört.

Wert

Bedeutung

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. Es ist zwingend erforderlich, dieses Flag nur zu verwenden, wenn Sie garantieren können, dass Sie das Cookie niemals über einen von Ihnen bereitgestellten Erweiterungsmechanismus dem Drittanbietercode zur Verfügung stellen.

Version: Erfordert Internet Explorer 8.0 oder höher.

INTERNET_COOKIE_THIRD_PARTY

Ruft nur Cookies von Drittanbietern ab, wenn die Richtlinie explizit zulässt, dass alle Cookies für die angegebene URL abgerufen werden.

INTERNET_FLAG_RESTRICTED_ZONE

Ruft nur Cookies ab, die zulässig wären, wenn die angegebene URL nicht vertrauenswürdig wäre; d. h., wenn sie zur zone URLZONE_UNTRUSTED gehört.

[in] lpReserved

Reserviert für die zukünftige Verwendung. Wird auf NULL-festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TRUEzurück.

Wenn die Funktion fehlschlägt, wird FALSE-zurückgegeben. Rufen Sie GetLastErrorauf, um einen bestimmten Fehlerwert abzurufen.

Wenn NULL- an lpszCookieData-übergeben wird, wird der Aufruf erfolgreich ausgeführt, und die Funktion wird nicht ERROR_INSUFFICIENT_BUFFERfestgelegt.

Die folgenden Fehlercodes können von dieser Funktion festgelegt werden.

Rückgabecode	Beschreibung
ERROR_INSUFFICIENT_BUFFER	Wird zurückgegeben, wenn die abgerufenen Cookiedaten größer als die Puffergröße ist, auf die durch den pcchCookieData Parameter verwiesen wird oder dieser Parameter NULL-ist.
ERROR_INVALID_PARAMETER	Wird zurückgegeben, wenn der pchURL- oder der pcchCookieData-Parameter nullist.
ERROR_NO_MORE_ITEMS	Wird zurückgegeben, wenn keine cookieierten Daten wie angegeben abgerufen werden können.

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 InternetGetCookieEx 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 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