GetExplicitEntriesFromAclA, fonction (aclapi.h)

Article
08/22/2023

La fonction GetExplicitEntriesFromAcl récupère un tableau de structures qui décrivent les entrées de contrôle d’accès dans une liste de contrôle d’accès (ACL).

Syntaxe

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

Paramètres

[in] pacl

Pointeur vers une structure ACL à partir de laquelle obtenir des informations ACE .

[out] pcCountOfExplicitEntries

Pointeur vers une variable qui reçoit le nombre de structures EXPLICIT_ACCESS retournées dans le tableau pListOfExplicitEntries .

[out] pListOfExplicitEntries

Pointeur vers une variable qui reçoit un pointeur vers un tableau de structures EXPLICIT_ACCESS qui décrivent les AES dans la liste de contrôle d’accès. Si la fonction réussit, vous devez appeler la fonction LocalFree pour libérer la mémoire tampon retournée.

Valeur retournée

Si la fonction réussit, la fonction retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne un code d’erreur différent de zéro défini dans WinError.h.

Remarques

Chaque entrée dans le tableau de structures de EXPLICIT_ACCESS décrit les informations de contrôle d’accès d’un ACE pour un fiduciaire. Un fiduciaire peut être un utilisateur, un groupe ou un programme (tel qu’un service Windows).

Chaque structure EXPLICIT_ACCESS spécifie un ensemble de droits d’accès et un indicateur de mode d’accès qui indique si l’ACE autorise, refuse ou audite les droits spécifiés.

Pour une liste de contrôle d’accès discrétionnaire (DACL), l’indicateur de mode d’accès peut être GRANT_ACCESS ou DENY_ACCESS. Pour plus d’informations sur ces valeurs, consultez ACCESS_MODE.

Pour une liste de contrôle d’accès système (SACL), l’indicateur de mode d’accès peut être SET_AUDIT_ACCESS, SET_AUDIT_FAILURE ou les deux. Pour plus d’informations sur ces valeurs, consultez ACCESS_MODE.

Notes

L’en-tête aclapi.h définit GetExplicitEntriesFromAcl comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	aclapi.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll