InternetEnumPerSiteCookieDecisionW-Funktion (winineti.h)

Artikel
11/20/2024

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

Syntax

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

Parameter

[out] pszSiteName

Eine LPSTR-, die eine Zeichenfolge empfängt, die eine Websitedomäne angibt.

[in, out] pcSiteNameSize

Ein Zeiger auf einen nicht signierten Wert, der die Größe des pcSiteNameSize Parameter angibt, der der InternetEnumPerSiteCookieDecision-Funktion beim Aufrufen bereitgestellt wird. Wenn InternetEnumPerSiteCookieDecision zurückgibt, erhält pcSiteNameSize die tatsächliche Länge der in pszSiteNamezurückgegebenen Domänenzeichenfolge.

[out] pdwDecision

Zeiger auf einen nicht signierten Wert, der den InternetCookieState Enumerationswert erhält, der pszSiteName-entspricht.

[in] dwIndex

Eine nicht signierte Lange, die 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.

Bemerkungen

InternetEnumPerSiteCookieDecision- sollte zunächst mit dwIndex- gleich 0 aufgerufen werden. Durch das Erhöhen des dwIndex- Parameters werden die Schritte in der Liste der Websites und Cookie-Einstellungen beschrieben. Das Ende der Liste wird erreicht, wenn InternetEnumPerSiteCookieDecisionFALSE- zurückgibt und den Wininet-Fehler ERROR_NO_MORE_ITEMSerzeugt.

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

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 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winineti.h (include Wininet.h, Winineti.h)
Library	Wininet.lib
DLL-	Wininet.dll

Siehe auch

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision-

InternetSetPerSiteCookieDecision-

PrivacyGetZonePreferenceW-

PrivacySetZonePreferenceW-

Freigeben über