Funzione InternetEnumPerSiteCookieDecisionA (wininet.h)

Articolo
11/20/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

Un 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 chiamato. Quando viene restituito InternetEnumPerSiteCookieDecision, 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 corrispondente del cookie da recuperare.

Valore restituito

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

Osservazioni

InternetEnumPerSiteCookieDecision deve essere chiamato inizialmente con dwIndex uguale a 0. Incrementando il parametro dwIndex attraverso l'elenco dei siti Web e delle impostazioni dei cookie. La fine dell'elenco viene raggiunta quando InternetEnumPerSiteCookieDecision restituisce FALSE 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 dall'interno di 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 Servizi HTTP Di Microsoft Windows (WinHTTP).

Nota

L'intestazione wininet.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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wininet.h (include Wininet.h, Winineti.h)
libreria	Wininet.lib
dll	Wininet.dll

Vedere anche

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW

Condividi tramite