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