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