GetSecurityDescriptorSacl, fonction (securitybaseapi.h)
La fonction GetSecurityDescriptorSacl récupère un pointeur vers la liste de contrôle d’accès système (SACL) dans un descripteur de sécurité spécifié.
Syntaxe
BOOL GetSecurityDescriptorSacl(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] LPBOOL lpbSaclPresent,
[out] PACL *pSacl,
[out] LPBOOL lpbSaclDefaulted
);
Paramètres
[in] pSecurityDescriptor
Pointeur vers la structure SECURITY_DESCRIPTOR qui contient la liste SACL vers laquelle la fonction récupère un pointeur.
[out] lpbSaclPresent
Pointeur vers un indicateur que la fonction définit pour indiquer la présence d’une liste de contrôle d’accès partagé dans le descripteur de sécurité spécifié. Si ce paramètre a la valeur TRUE, le descripteur de sécurité contient une liste SACL et les paramètres de sortie restants de cette fonction reçoivent des valeurs valides. Si ce paramètre a la valeur FALSE, le descripteur de sécurité ne contient pas de liste SACL et les paramètres de sortie restants ne reçoivent pas de valeurs valides.
[out] pSacl
Pointeur vers un pointeur vers une liste de contrôle d’accès (ACL). S’il existe une liste de contrôle d’accès partagé, la fonction définit le pointeur pointé par pSacl vers l’adresse de la liste SACL du descripteur de sécurité. Si une liste de contrôle d’accès partagé n’existe pas, aucune valeur n’est stockée.
Si la fonction stocke une valeur NULL dans le pointeur pointé vers pSacl, le descripteur de sécurité a une liste SACL NULL .
[out] lpbSaclDefaulted
Pointeur vers un indicateur qui est défini sur la valeur de l’indicateur de SE_SACL_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL si une liste de contrôle d’accès partagé existe pour le descripteur de sécurité.
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 |