Funzione GetExplicitEntriesFromAclA (aclapi.h)

Articolo
11/20/2024

La funzione GetExplicitEntriesFromAcl recupera una matrice di strutture che descrivono le voci di controllo di accesso (ACL) 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 di ACL da cui ottenere informazioni ACE.

[out] pcCountOfExplicitEntries

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

[out] pListOfExplicitEntries

Puntatore a una variabile che riceve un puntatore a una matrice di strutture EXPLICIT_ACCESS che descrivono gli ACL nell'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.

Osservazioni

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 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 di 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 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 XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	aclapi.h
libreria	Advapi32.lib
dll	Advapi32.dll