InternetEnumPerSiteCookieDecisionA-Funktion (winineti.h)

Artikel
03/09/2024

Ruft die Domänen und Cookie-Einstellungen von Websites ab, für die websitespezifische Cookie-Vorschriften festgelegt sind.

Syntax

BOOL InternetEnumPerSiteCookieDecisionA(
  [out]     LPSTR         pszSiteName,
  [in, out] unsigned long *pcSiteNameSize,
  [out]     unsigned long *pdwDecision,
  [in]      unsigned long dwIndex
);

Parameter

[out] pszSiteName

Ein LPSTR , der eine Zeichenfolge empfängt, die eine Websitedomäne angibt.

[in, out] pcSiteNameSize

Ein Zeiger auf einen long-Wert ohne Vorzeichen, der die Größe des parameters pcSiteNameSize angibt, der der InternetEnumPerSiteCookieDecision-Funktion beim Aufruf bereitgestellt wird. Wenn InternetEnumPerSiteCookieDecision zurückgibt, empfängt pcSiteNameSize die tatsächliche Länge der in pszSiteName zurückgegebenen Domänenzeichenfolge.

[out] pdwDecision

Zeiger auf einen long-Wert ohne Vorzeichen, der den InternetCookieState-Enumerationswert empfängt, der pszSiteName entspricht.

[in] dwIndex

Ein unsigned long, der den Index der Website und die entsprechende cookie-Einstellung angibt, die abgerufen werden soll.

Rückgabewert

TRUE , wenn die Funktion die Cookieeinstellung für die angegebene Domäne abgerufen hat; Andernfalls false. FALSE.

Hinweise

InternetEnumPerSiteCookieDecision sollte zunächst mit dwIndex gleich 0 aufgerufen werden. Das Inkrementieren des dwIndex-Parameters durchläuft die Liste der Websites und Cookieeinstellungen. Das Ende der Liste wird erreicht, wenn InternetEnumPerSiteCookieDecisionFALSE zurückgibt und den wininet-Fehler ERROR_NO_MORE_ITEMS.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

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 winineti.h-Header definiert InternetEnumPerSiteCookieDecision 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 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winineti.h (include Wininet.h, Winineti.h)
Bibliothek	Wininet.lib
DLL	Wininet.dll