Funzione GetExplicitEntriesFromAclA (aclapi.h)
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 |