Fonction RtlGetAce (ntifs.h)

La routine RtlGetAce 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

NTSYSAPI NTSTATUS RtlGetAce(
  [in]  PACL  Acl,
  [in]  ULONG AceIndex,
  [out] PVOID *Ace
);

Paramètres

[in] Acl

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

[in] AceIndex

Spécifie l’ACE vers lequel un pointeur est récupéré. Une valeur de zéro correspond au premier ACE de la liste de contrôle d’accès, 1 au deuxième ACE, et ainsi de suite.

[out] Ace

Pointeur vers une variable allouée par l’appelant pour recevoir l’adresse de l’ACE dans la liste de contrôle d’accès.

Valeur retournée

RtlGetAce retourne STATUS_SUCCESS ou un code d’erreur status tel que STATUS_INVALID_PARAMETER.

Remarques

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez Modèle de sécurité Windows pour les développeurs de pilotes et la documentation sur ces rubriques dans le Kit de développement logiciel (SDK) Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	< DISPATCH_LEVEL

Voir aussi

ACE

ACL

RtlCreateAcl