GetSecurityDescriptorSacl, fonction (securitybaseapi.h)

Article
08/25/2023

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