Partager via

SetFileSecurityW, fonction (securitybaseapi.h)

  • Article

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

Cette fonction est obsolète. Utilisez plutôt la fonction SetNamedSecurityInfo .

Syntaxe

BOOL SetFileSecurityW(
  [in] LPCWSTR              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 annuaire 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é vers lequel pointe 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 WRITE_OWNER autorisation 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 le 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 securitybaseapi.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

GetFileSecurity
Access Control de bas niveau
Fonctions Access Control de bas niveau
SECURITY_DESCRIPTOR
SECURITY_INFORMATION
SetKernelObjectSecurity
SetNamedSecurityInfoSetPrivateObjectSecurity
SetUserObjectSecurity