Fonction FindFirstFreeAce (securitybaseapi.h)

  • Article

La fonction FindFirstFreeAce récupère un pointeur vers le premier octet libre d’une liste de contrôle d’accès (ACL).

Syntaxe

BOOL FindFirstFreeAce(
  [in]  PACL   pAcl,
  [out] LPVOID *pAce
);

Paramètres

[in] pAcl

Pointeur vers une liste de contrôle d’accès.

[out] pAce

Adresse d’un pointeur vers la première position libre dans la liste de contrôle d’accès créée lorsque la fonction retourne. Si la liste de contrôle d’accès n’est pas valide, ce paramètre est NULL. Si la liste de contrôle d’accès est pleine, ce paramètre pointe vers l’octet immédiatement après la liste de contrôle d’accès.

Valeur retournée

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

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête securitybaseapi.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

GetAce

GetAclInformation

Access Control de bas niveau

Fonctions Access Control de bas niveau