GetAclInformation, fonction (securitybaseapi.h)
La fonction GetAclInformation récupère des informations sur une liste de contrôle d’accès (ACL).
Syntaxe
BOOL GetAclInformation(
[in] PACL pAcl,
[out] LPVOID pAclInformation,
[in] DWORD nAclInformationLength,
[in] ACL_INFORMATION_CLASS dwAclInformationClass
);
Paramètres
[in] pAcl
Pointeur vers une liste de contrôle d’accès. La fonction récupère des informations sur cette liste de contrôle d’accès. Si une valeur null est transmise, la fonction provoque une violation d’accès.
[out] pAclInformation
Pointeur vers une mémoire tampon pour recevoir les informations demandées. La structure placée dans la mémoire tampon dépend de la classe d’informations demandée dans le paramètre dwAclInformationClass .
[in] nAclInformationLength
Taille, en octets, de la mémoire tampon pointée vers le paramètre pAclInformation .
[in] dwAclInformationClass
Valeur de l’énumération ACL_INFORMATION_CLASS qui indique la classe d’informations demandée. Ce paramètre peut être l’une des deux valeurs de cette énumération :
- Si la valeur est AclRevisionInformation, la fonction remplit la mémoire tampon pointée par le paramètre pAclInformation avec une structure ACL_REVISION_INFORMATION .
- Si la valeur est AclSizeInformation, la fonction remplit la mémoire tampon pointée par le paramètre pAclInformation avec une structure ACL_SIZE_INFORMATION .
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 | 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 |