Condividi tramite


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

Vedi anche

ACCESS_ALLOWED_ACE

ACCESS_DENIED_ACE

ACCESS_MODE

ACE

ACL

Controllo dell’accesso

Funzioni di base Controllo di accesso

EXPLICIT_ACCESS

LocalFree

SYSTEM_AUDIT_ACE