Freigeben über


File.GetAccessControl Methode

Definition

Ruft ein FileSecurity -Objekt ab, das die Zugriffssteuerungslisteneinträge (Access Control List, ACL) für eine angegebene Datei kapselt.

Überlädt

GetAccessControl(String)

Ruft ein FileSecurity -Objekt ab, das die Zugriffssteuerungslisteneinträge (Access Control List, ACL) für eine angegebene Datei kapselt.

GetAccessControl(String, AccessControlSections)

Ruft ein FileSecurity -Objekt ab, das den angegebenen Typ von Zugriffssteuerungslisteneinträgen (Access Control List, ACL) für eine bestimmte Datei kapselt.

GetAccessControl(String)

Ruft ein FileSecurity -Objekt ab, das die Zugriffssteuerungslisteneinträge (Access Control List, ACL) für eine angegebene Datei kapselt.

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.FileSecurity
Public Shared Function GetAccessControl (path As String) As FileSecurity

Parameter

path
String

Der Pfad zu einer Datei, die ein FileSecurity-Objekt enthält, das die ACL-Informationen (Access Control List) der Datei beschreibt.

Gibt zurück

Ein FileSecurity -Objekt, das die Zugriffssteuerungsregeln für die datei kapselt, die durch den parameter path beschrieben wird.

Ausnahmen

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

Der parameter path ist null.

Die Datei konnte nicht gefunden werden.

Der path Parameter hat eine Datei angegeben, die schreibgeschützt ist.

-oder-

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

-oder-

Der path Parameter hat ein Verzeichnis angegeben.

-oder-

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Verwenden Sie die GetAccessControl-Methode, um die ACL-Einträge (Access Control List) für eine Datei abzurufen.

Eine ACL beschreibt Einzelpersonen und Gruppen, die über bestimmte Aktionen für die angegebene Datei verfügen oder keine Rechte haben. Weitere Informationen finden Sie unter How to: Add or Remove Access Control List Entries.

In NTFS-Umgebungen werden dem Benutzer ReadAttributes und ReadExtendedAttributes gewährt, wenn der Benutzer über ListDirectory Rechte für den übergeordneten Ordner verfügt. Um ReadAttributes und ReadExtendedAttributeszu verweigern, verweigern Sie ListDirectory im übergeordneten Verzeichnis.

Gilt für:

GetAccessControl(String, AccessControlSections)

Ruft ein FileSecurity -Objekt ab, das den angegebenen Typ von Zugriffssteuerungslisteneinträgen (Access Control List, ACL) für eine bestimmte Datei kapselt.

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.FileSecurity
Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

Parameter

path
String

Der Pfad zu einer Datei, die ein FileSecurity-Objekt enthält, das die ACL-Informationen (Access Control List) der Datei beschreibt.

includeSections
AccessControlSections

Einer der AccessControlSections Werte, die den Typ der empfangenen Zugriffssteuerungslisteninformationen (Access Control List, ACL) angibt.

Gibt zurück

Ein FileSecurity -Objekt, das die Zugriffssteuerungsregeln für die datei kapselt, die durch den parameter path beschrieben wird.

Ausnahmen

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

Der parameter path ist null.

Die Datei konnte nicht gefunden werden.

Der path Parameter hat eine Datei angegeben, die schreibgeschützt ist.

-oder-

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

-oder-

Der path Parameter hat ein Verzeichnis angegeben.

-oder-

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Verwenden Sie die GetAccessControl-Methode, um die ACL-Einträge (Access Control List) für eine Datei abzurufen.

Eine ACL beschreibt Einzelpersonen und Gruppen, die über bestimmte Aktionen für die angegebene Datei verfügen oder keine Rechte haben. Weitere Informationen finden Sie unter How to: Add or Remove Access Control List Entries.

In NTFS-Umgebungen werden dem Benutzer ReadAttributes und ReadExtendedAttributes gewährt, wenn der Benutzer über ListDirectory Rechte für den übergeordneten Ordner verfügt. Um ReadAttributes und ReadExtendedAttributeszu verweigern, verweigern Sie ListDirectory im übergeordneten Verzeichnis.

Gilt für: