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 |