Fonction FindFirstFreeAce (securitybaseapi.h)
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 |