File.GetAccessControl 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.
Obtient un FileSecurity objet qui encapsule les entrées de liste de contrôle d’accès (ACL) pour un fichier spécifié.
Surcharges
| Nom | Description |
|---|---|
| GetAccessControl(String) |
Obtient un FileSecurity objet qui encapsule les entrées de liste de contrôle d’accès (ACL) pour un fichier spécifié. |
| GetAccessControl(String, AccessControlSections) |
Obtient un FileSecurity objet qui encapsule le type spécifié d’entrées de liste de contrôle d’accès (ACL) pour un fichier particulier. |
GetAccessControl(String)
Obtient un FileSecurity objet qui encapsule les entrées de liste de contrôle d’accès (ACL) pour un fichier spécifié.
public:
static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path);public static System.Security.AccessControl.FileSecurity GetAccessControl(string path);static member GetAccessControl : string -> System.Security.AccessControl.FileSecurityPublic Shared Function GetAccessControl (path As String) As FileSecurityParamètres
- path
- String
Chemin d’accès à un fichier contenant un FileSecurity objet qui décrit les informations de liste de contrôle d’accès (ACL) du fichier.
Retours
Objet FileSecurity qui encapsule les règles de contrôle d’accès pour le fichier décrit par le path paramètre.
Exceptions
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
Le path paramètre est null.
Impossible de trouver le fichier.
Le path paramètre a spécifié un fichier en lecture seule.
-ou-
Cette opération n’est pas prise en charge sur la plateforme actuelle.
-ou-
Le path paramètre a spécifié un répertoire.
-ou-
L’appelant n’a pas l’autorisation requise.
Remarques
Utilisez la GetAccessControl méthode pour récupérer les entrées de liste de contrôle d’accès (ACL) d’un 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 Comment : ajouter ou supprimer des entrées de liste de contrôle d’accès.
Dans les environnements NTFS, ReadAttributes et ReadExtendedAttributes sont accordés à l’utilisateur si l’utilisateur dispose ListDirectory de droits sur le dossier parent. Pour refuser et ReadExtendedAttributesrefuser ReadAttributesListDirectory sur le répertoire parent.
S’applique à
GetAccessControl(String, AccessControlSections)
Obtient un FileSecurity objet qui encapsule le type spécifié d’entrées de liste de contrôle d’accès (ACL) pour un fichier particulier.
public:
static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);public static System.Security.AccessControl.FileSecurity GetAccessControl(string path, System.Security.AccessControl.AccessControlSections includeSections);static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurityPublic Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurityParamètres
- path
- String
Chemin d’accès à un fichier contenant un FileSecurity objet qui décrit les informations de liste de contrôle d’accès (ACL) du fichier.
- includeSections
- AccessControlSections
Une des AccessControlSections valeurs qui spécifie le type d’informations de liste de contrôle d’accès à recevoir.
Retours
Objet FileSecurity qui encapsule les règles de contrôle d’accès pour le fichier décrit par le path paramètre.
Exceptions
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
Le path paramètre est null.
Impossible de trouver le fichier.
Le path paramètre a spécifié un fichier en lecture seule.
-ou-
Cette opération n’est pas prise en charge sur la plateforme actuelle.
-ou-
Le path paramètre a spécifié un répertoire.
-ou-
L’appelant n’a pas l’autorisation requise.
Remarques
Utilisez la GetAccessControl méthode pour récupérer les entrées de liste de contrôle d’accès (ACL) d’un 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 Comment : ajouter ou supprimer des entrées de liste de contrôle d’accès.
Dans les environnements NTFS, ReadAttributes et ReadExtendedAttributes sont accordés à l’utilisateur si l’utilisateur dispose ListDirectory de droits sur le dossier parent. Pour refuser et ReadExtendedAttributesrefuser ReadAttributesListDirectory sur le répertoire parent.