Funzione InternetEnumPerSiteCookieDecisionA (wininet.h)

Articolo
03/08/2023

Recupera i domini e le impostazioni dei cookie dei siti Web per i quali vengono impostate normative 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 long senza segno che specifica le dimensioni del parametro pcSiteNameSize fornito alla funzione InternetEnumPerSiteCookieDecieDecision quando viene chiamata. Quando InternetEnumPerSiteCookieDecision restituisce, pcSiteNameSize riceve la lunghezza effettiva della stringa di dominio restituita in pszSiteName.

[out] pdwDecision

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

[in] dwIndex

Lungo 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.

Commenti

InternetEnumPerSiteCookieDecision deve essere inizialmente chiamato con dwIndex uguale a 0. Incremento dei passaggi dei parametri dwIndex tramite l'elenco di siti Web e 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 degli oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni o i servizi server usano Microsoft Windows HTTP Services (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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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	wininet.h (include Wininet.h, Winineti.h)
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW

Condividi tramite