Fonction SetFileSecurityA (winbase.h)

Article
08/27/2023

La fonction SetFileSecurity définit la sécurité d’un objet de fichier ou de répertoire.

Cette fonction est obsolète. Utilisez la fonction SetNamedSecurityInfo à la place.

Syntaxe

BOOL SetFileSecurityA(
  [in] LPCSTR               lpFileName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Paramètres

[in] lpFileName

Pointeur vers une chaîne terminée par null qui spécifie le fichier ou le répertoire pour lequel la sécurité est définie. Notez que la sécurité appliquée à un répertoire n’est pas héritée par ses enfants.

[in] SecurityInformation

Spécifie une structure SECURITY_INFORMATION qui identifie le contenu du descripteur de sécurité pointé vers le paramètre pSecurityDescriptor .

[in] pSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR .

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.

Remarques

La fonction SetFileSecurity réussit uniquement si les conditions suivantes sont remplies :

Si le propriétaire de l’objet est défini, le processus appelant doit avoir l’autorisation WRITE_OWNER ou être le propriétaire de l’objet.
Si la liste de contrôle d’accès discrétionnaire (DACL) de l’objet est définie, le processus appelant doit avoir WRITE_DAC autorisation ou être propriétaire de l’objet.
Si la liste de contrôle d’accès système (SACL) de l’objet est définie, le privilège SE_SECURITY_NAME doit être activé pour le processus appelant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll