Partager via


Fonction DeleteAce (securitybaseapi.h)

La fonction DeleteAce supprime une entrée de contrôle d’accès (ACE) d’une liste de contrôle d’accès (ACL).

Syntaxe

BOOL DeleteAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceIndex
);

Paramètres

[in, out] pAcl

Pointeur vers une liste de contrôle d’accès. L’ACE spécifié par le paramètre dwAceIndex est supprimé de cette liste de contrôle d’accès.

[in] dwAceIndex

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

Valeur retournée

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

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Une application peut utiliser la structure ACL_SIZE_INFORMATION récupérée par la fonction GetAclInformation pour découvrir la taille de la liste de contrôle d’accès et le nombre d’AAC qu’elle contient. La fonction GetAce récupère des informations sur un ACE individuel.

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

Voir aussi

ACL_SIZE_INFORMATION

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAce

GetAclInformation

Access Control de bas niveau

Fonctions Access Control de bas niveau