File.SetAccessControl(String, FileSecurity) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Applique les entrées de liste de contrôle d’accès (ACL) décrites par un objet FileSecurity au fichier spécifié.
public:
static void SetAccessControl(System::String ^ path, System::Security::AccessControl::FileSecurity ^ fileSecurity);public static void SetAccessControl (string path, System.Security.AccessControl.FileSecurity fileSecurity);static member SetAccessControl : string * System.Security.AccessControl.FileSecurity -> unitPublic Shared Sub SetAccessControl (path As String, fileSecurity As FileSecurity)Paramètres
- path
- String
Fichier à partir duquel ajouter ou supprimer des entrées de liste de contrôle d’accès (ACL).
- fileSecurity
- FileSecurity
Objet FileSecurity qui décrit une entrée de liste de contrôle d’accès à appliquer au fichier décrit par le paramètre path.
Exceptions
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
Le paramètre path est null.
Impossible de trouver le fichier.
Le paramètre path a spécifié un fichier en lecture seule.
-ou-
Cette opération n’est pas prise en charge sur la plateforme actuelle.
-ou-
Le paramètre path a spécifié un répertoire.
-ou-
L’appelant n’a pas l’autorisation requise.
Le paramètre fileSecurity est null.
Remarques
La méthode SetAccessControl applique des entrées de liste de contrôle d’accès (ACL) à un fichier qui représente la liste ACL non utilisée.
Prudence
La liste de contrôle d’accès spécifiée pour le paramètre fileSecurity remplace la liste de contrôle d’accès existante pour le fichier. Pour ajouter des autorisations pour un nouvel utilisateur, utilisez la méthode GetAccessControl pour obtenir la liste de contrôle d’accès existante, la modifier, puis utilisez SetAccessControl pour l’appliquer au fichier.
Une liste de contrôle d’accès décrit les personnes et les groupes qui ont, ou n’ont pas, des droits pour des actions spécifiques sur le fichier donné. Pour plus d’informations, consultez Guide pratique pour ajouter ou supprimer des entrées de liste de contrôle d’accès.
La méthode SetAccessControl conserve uniquement FileSecurity objets qui ont été modifiés après la création de l’objet. Si un objet FileSecurity n’a pas été modifié, il ne sera pas conservé dans un fichier. Par conséquent, il n’est pas possible de récupérer un objet FileSecurity à partir d’un fichier et de réappliquer le même objet à un autre fichier.
Pour copier des informations de liste de contrôle d’accès d’un fichier vers un autre :
Utilisez la méthode GetAccessControl pour récupérer l’objet FileSecurity à partir du fichier source.
Créez un objet FileSecurity pour le fichier de destination.
Utilisez la méthode GetSecurityDescriptorBinaryForm ou GetSecurityDescriptorSddlForm de l’objet FileSecurity source pour récupérer les informations de liste de contrôle d’accès.
Utilisez la méthode SetSecurityDescriptorBinaryForm ou SetSecurityDescriptorSddlForm pour copier les informations récupérées à l’étape 3 dans l’objet FileSecurity de destination.
Définissez l’objet FileSecurity de destination sur le fichier de destination à l’aide de la méthode SetAccessControl.
Dans les environnements NTFS, ReadAttributes et ReadExtendedAttributes sont accordés à l’utilisateur si l’utilisateur a ListDirectory droits sur le dossier parent. Pour refuser ReadAttributes et ReadExtendedAttributes, refusez ListDirectory sur le répertoire parent.
