Fonction RtlDeleteAce (ntifs.h)

Article
10/04/2023

La routine RtlDeleteAce supprime une entrée de contrôle d’accès (ACE) d’une liste de contrôle d’accès (ACL) spécifiée.

Syntaxe

NTSYSAPI NTSTATUS RtlDeleteAce(
  [in, out] PACL  Acl,
  [in]      ULONG AceIndex
);

Paramètres

[in, out] Acl

Pointeur vers la liste de contrôle d’accès à modifier. RtlDeleteAce supprime l’ACE spécifié de cette liste de contrôle d’accès.

[in] AceIndex

Spécifie l’ACE à supprimer. Une valeur de zéro correspond au premier ACE de l’ACL, 1 au deuxième ACE, et ainsi de suite.

Valeur retournée

RtlDeleteAce retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que l’une des valeurs suivantes :

Code de retour	Description
STATUS_INVALID_PARAMETER	L’une des valeurs de paramètre n’était pas valide.

Les raisons possibles de STATUS_INVALID_PARAMETER sont les suivantes :

La liste de contrôle d’accès spécifiée n’est pas valide.
La valeur d’index spécifiée est hors limites.
STATUS_INVALID_PARAMETER est un code d’erreur.

Remarques

Pour plus d’informations sur le calcul de la taille d’une liste de contrôle d’accès, consultez la section Notes de l’entrée de référence pour RtlCreateAcl.

Pour ajouter un ACE à une liste de contrôle d’accès, utilisez RtlAddAce.

Pour obtenir un pointeur vers un ACE dans une liste de contrôle d’accès, utilisez RtlGetAce.

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 Server 2003 SP1
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi