Fonction SetSecurityDescriptorSacl (securitybaseapi.h)

Article
03/04/2024

La fonction SetSecurityDescriptorSacl définit des informations dans une liste de contrôle d’accès système (SACL). S’il existe déjà une liste SACL présente dans le descripteur de sécurité, elle est remplacée.

Syntaxe

BOOL SetSecurityDescriptorSacl(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]           BOOL                 bSaclPresent,
  [in, optional] PACL                 pSacl,
  [in]           BOOL                 bSaclDefaulted
);

Paramètres

[in, out] pSecurityDescriptor

Pointeur vers la structure SECURITY_DESCRIPTOR à laquelle la fonction ajoute la liste SACL. Ce descripteur de sécurité doit être au format absolu, ce qui signifie que ses membres doivent être des pointeurs vers d’autres structures, plutôt que des décalages vers des données contiguës.

[in] bSaclPresent

Indique la présence d’une liste SACL dans le descripteur de sécurité. Si ce paramètre a la valeur TRUE, la fonction définit l’indicateur de SE_SACL_PRESENT dans la structure SECURITY_DESCRIPTOR_CONTROL et utilise les valeurs des paramètres pSacl et bSaclDefaulted . Si la valeur est FALSE, la fonction ne définit pas l’indicateur SE_SACL_PRESENT, et pSacl et bSaclDefaulted sont ignorés.

[in, optional] pSacl

Pointeur vers une structure ACL qui spécifie la saCL pour le descripteur de sécurité. Si ce paramètre a la valeur NULL, une liste SACL NULL est affectée au descripteur de sécurité. La liste saCL est référencée par le descripteur de sécurité, et non copié dans.

[in] bSaclDefaulted

Indique la source de la liste SACL. Si cet indicateur a la valeur TRUE, la liste SACL a été récupérée par un mécanisme par défaut. Si elle a la valeur FALSE, la liste de contrôle d’accès partagé a été spécifiée explicitement par un utilisateur. La fonction stocke cette valeur dans l’indicateur SE_SACL_DEFAULTED de la structure SECURITY_DESCRIPTOR_CONTROL . Si ce paramètre n’est pas spécifié, l’indicateur SE_SACL_DEFAULTED est effacé.

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