Fonction SetFileSecurityA (winbase.h)
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 |