Fonction RtlDeleteAce (ntifs.h)
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. La valeur zéro correspond au premier ACE dans la liste de contrôle d’accès, 1 au deuxième ACE, et ainsi de suite.
Valeur de retour
RtlDeleteAce retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | L’une des valeurs de paramètre n’est pas valide. |
Les raisons possibles pour 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 plage.
- 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Server 2003 SP1 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |