Funzione GetExplicitEntriesFromAclA (aclapi.h)

Articolo
02/28/2024

La funzione GetExplicitEntriesFromAcl recupera una matrice di strutture che descrivono le voci del controllo di accesso in un elenco di controllo di accesso (ACL).

Sintassi

DWORD GetExplicitEntriesFromAclA(
  [in]  PACL               pacl,
  [out] PULONG             pcCountOfExplicitEntries,
  [out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);

Parametri

[in] pacl

Puntatore a una struttura ACL da cui ottenere informazioni ACE .

[out] pcCountOfExplicitEntries

Puntatore a una variabile che riceve il numero di strutture EXPLICIT_ACCESS restituite nella matrice pListOfExplicitEntries .

[out] pListOfExplicitEntries

Puntatore a una variabile che riceve un puntatore a una matrice di strutture EXPLICIT_ACCESS che descrivono gli ACL. Se la funzione ha esito positivo, è necessario chiamare la funzione LocalFree per liberare il buffer restituito.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice di errore diverso da zero definito in WinError.h.

Commenti

Ogni voce nella matrice di strutture di EXPLICIT_ACCESS descrive le informazioni di controllo di accesso da un ace per un trustee. Un trustee può essere un utente, un gruppo o un programma (ad esempio un servizio Windows).

Ogni struttura EXPLICIT_ACCESS specifica un set di diritti di accesso e un flag di modalità di accesso che indica se l'ACE consente, nega o controlla i diritti specificati.

Per un elenco di controllo di accesso discrezionale (DACL), il flag della modalità di accesso può essere GRANT_ACCESS o DENY_ACCESS. Per informazioni su questi valori, vedere ACCESS_MODE.

Per un elenco di controllo di accesso del sistema (SACL), il flag della modalità di accesso può essere SET_AUDIT_ACCESS, SET_AUDIT_FAILURE o entrambi. Per informazioni su questi valori, vedere ACCESS_MODE.

Nota

L'intestazione aclapi.h definisce GetExplicitEntriesFromAcl 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 XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	aclapi.h
Libreria	Advapi32.lib
DLL	Advapi32.dll