Share via


GetAce, fonction (securitybaseapi.h)

La fonction GetAce obtient un pointeur vers une entrée de contrôle d’accès (ACE) dans une liste de contrôle d’accès (ACL).

Syntaxe

BOOL GetAce(
  [in]  PACL   pAcl,
  [in]  DWORD  dwAceIndex,
  [out] LPVOID *pAce
);

Paramètres

[in] pAcl

Pointeur vers une liste de contrôle d’accès qui contient l’ACE à récupérer.

[in] dwAceIndex

Index de l’ACE à récupérer. Une valeur de zéro correspond au premier ACE dans l’ACL, une valeur de un à la deuxième ACE, et ainsi de suite.

[out] pAce

Pointeur vers un pointeur que la fonction définit sur l’adresse de l’ACE.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Spécifications

   
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 securitybaseapi.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

Access Control de bas niveau

Fonctions Access Control de bas niveau