InternetGetCookieExA-Funktion (wininet.h)

Artikel
08/27/2023

Die InternetGetCookieEx-Funktion ruft Daten ab, die in Cookies gespeichert sind, die einer angegebenen URL zugeordnet sind. Im Gegensatz zu InternetGetCookie kann InternetGetCookieEx verwendet werden, um abgerufene Daten auf einen einzelnen Cookienamen zu beschränken oder gemäß einer Richtlinie, die nicht vertrauenswürdigen Websites oder Cookies von Drittanbietern zugeordnet sind.

Syntax

BOOL InternetGetCookieExA(
  [in]                LPCSTR  lpszUrl,
  [in]                LPCSTR  lpszCookieName,
  [in, out, optional] LPSTR   lpszCookieData,
  [in, out]           LPDWORD lpdwSize,
  [in]                DWORD   dwFlags,
  [in]                LPVOID  lpReserved
);

Parameter

[in] lpszUrl

Ein Zeiger auf eine NULL-endende Zeichenfolge, die die URL enthält, der das abzurufende Cookie zugeordnet ist. Dieser Parameter darf nicht NULL sein, oder InternetGetCookieEx schlägt fehl und gibt einen ERROR_INVALID_PARAMETER Fehler zurück.

[in] lpszCookieName

Ein Zeiger auf eine NULL-endende 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.

Beim Eintrag muss die Variable die Größe des Puffers in TCHARs enthalten, auf den der parameter pchCookieData verweist.

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

Dieser Parameter darf nicht NULL sein, oder InternetGetCookieEx schlägt fehl und gibt einen ERROR_INVALID_PARAMETER Fehler zurück.

[in] dwFlags

Ein Flag, das steuert, wie die Funktion Cookiedaten abruft. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
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. Es ist zwingend erforderlich, dass Sie dieses Flag nur verwenden, wenn Sie garantieren können, dass Sie das Cookie niemals über einen von Ihnen bereitgestellten Erweiterbarkeitsmechanismus für Code von Drittanbietern verfügbar machen. 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. das heißt, wenn es zur URLZONE_UNTRUSTED Zone gehörte.

Wert

Bedeutung

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. Es ist zwingend erforderlich, dass Sie dieses Flag nur verwenden, wenn Sie garantieren können, dass Sie das Cookie niemals über einen von Ihnen bereitgestellten Erweiterbarkeitsmechanismus für Code von Drittanbietern verfügbar machen.

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. das heißt, wenn es zur URLZONE_UNTRUSTED Zone gehörte.

[in] lpReserved

Für die zukünftige Verwendung reserviert. Auf NULL festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TRUE zurück.

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

Wenn NULL an lpszCookieData übergeben wird, wird der Aufruf erfolgreich ausgeführt, und die Funktion legt ERROR_INSUFFICIENT_BUFFER nicht fest.

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 sind als die Puffergröße, auf die der parameter pcchCookieData verweist, oder wenn dieser Parameter NULL ist.
ERROR_INVALID_PARAMETER	Wird zurückgegeben, wenn entweder der pchURL - oder der pcchCookieData-ParameterNULL ist.
ERROR_NO_MORE_ITEMS	Wird zurückgegeben, wenn keine wie angegebenen Cookiedaten abgerufen werden können.

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).

Hinweis

Der wininet.h-Header definiert InternetGetCookieEx 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
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