InternetEnumPerSiteCookieDecisionA-Funktion (winineti.h)
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
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 |
Weitere Informationen
InternetClearAllPerSiteCookieDecisions
InternetGetPerSiteCookieDecision