Funzione InternetEnumPerSiteCookieDecisionA (winineti.h)

Articolo
03/04/2024

Recupera i domini e le impostazioni dei cookie dei siti Web per i quali sono impostate le normative sui cookie specifiche del sito.

Sintassi

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

Parametri

[out] pszSiteName

LPSTR che riceve una stringa che specifica un dominio del sito Web.

[in, out] pcSiteNameSize

Puntatore a un valore long senza segno che specifica le dimensioni del parametro pcSiteNameSize fornito alla funzione InternetEnumPerSiteCookieDecision quando viene chiamata. Quando InternetEnumPerSiteCookieDecision restituisce , pcSiteNameSize riceve la lunghezza effettiva della stringa di dominio restituita in pszSiteName.

[out] pdwDecision

Puntatore a un valore long senza segno che riceve il valore di enumerazione InternetCookieState corrispondente a pszSiteName.

[in] dwIndex

Valore long senza segno che specifica l'indice del sito Web e l'impostazione del cookie corrispondente da recuperare.

Valore restituito

TRUE se la funzione ha recuperato l'impostazione del cookie per il dominio specificato; in caso contrario, false. FALSE.

Commenti

InternetEnumPerSiteCookieDecision deve essere inizialmente chiamato con dwIndex uguale a 0. Incrementando i passaggi del parametro dwIndex tramite l'elenco di siti Web e impostazioni dei cookie. La fine dell'elenco viene raggiunta quando InternetEnumPerSiteCookieDecision restituisceFALSE e genera l'errore wininet , ERROR_NO_MORE_ITEMS.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro da DllMain o dai costruttori e distruttori di oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).

Nota

L'intestazione winineti.h definisce InternetEnumPerSiteCookieDecision come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winineti.h (include Wininet.h, Winineti.h)
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW

Condividi tramite