Fonction DeleteAce (securitybaseapi.h)

Article
06/03/2024

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

C++

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