GetExplicitEntriesFromAclA, fonction (aclapi.h)

Article
11/20/2024

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 de de liste de contrôle d’accès à 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 tableau.

[out] pListOfExplicitEntries

Pointeur vers une variable qui reçoit un pointeur vers un tableau de structures EXPLICIT_ACCESS qui décrivent les ACL. Si la fonction réussit, vous devez appeler la fonction LocalFree pour libérer la mémoire tampon retournée.

Valeur de retour

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 administrateur. Un administrateur peut être un utilisateur, un groupe ou un programme (par exemple, 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.

Note

L’en-tête aclapi.h définit GetExplicitEntriesFromAcl comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	aclapi.h
bibliothèque	Advapi32.lib
DLL	Advapi32.dll