Directory.GetAccessControl Methode

Definition

Namespace:

System.IO

Assembly:

mscorlib.dll

Gibt die Windows-Zugriffssteuerungsliste (Access Control List, ACL) für ein Verzeichnis zurück.

Überlädt

GetAccessControl(String)	Ruft ein DirectorySecurity -Objekt ab, das die Zugriffssteuerungslisteneinträge (Access Control List, ACL) für ein angegebenes Verzeichnis kapselt.
GetAccessControl(String, AccessControlSections)	Ruft ein DirectorySecurity -Objekt ab, das den angegebenen Typ von Zugriffssteuerungslisteneinträgen (Access Control List, ACL) für ein angegebenes Verzeichnis kapselt.

GetAccessControl(String)

Ruft ein DirectorySecurity -Objekt ab, das die Zugriffssteuerungslisteneinträge (Access Control List, ACL) für ein angegebenes Verzeichnis kapselt.

public:
 static System::Security::AccessControl::DirectorySecurity ^ GetAccessControl(System::String ^ path);

public static System.Security.AccessControl.DirectorySecurity GetAccessControl (string path);

static member GetAccessControl : string -> System.Security.AccessControl.DirectorySecurity

Public Shared Function GetAccessControl (path As String) As DirectorySecurity

Parameter

path

String

Der Pfad zu einem Verzeichnis, das ein DirectorySecurity-Objekt enthält, das die Informationen zur Zugriffssteuerungsliste (Access Control List, ACL) der Datei beschreibt.

Gibt zurück

DirectorySecurity

Ein Objekt, das die Zugriffssteuerungsregeln für die vom path-Parameter beschriebene Datei kapselt.

Ausnahmen

ArgumentNullException

Der parameter path ist null.

IOException

Beim Öffnen des Verzeichnisses ist ein E/A-Fehler aufgetreten.

SystemException

Fehler auf Systemebene, z. B. das Verzeichnis, konnte nicht gefunden werden. Die spezifische Ausnahme kann eine Unterklasse von SystemExceptionsein.

UnauthorizedAccessException

Der path Parameter hat ein Schreibgeschütztes Verzeichnis angegeben.

-oder-

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

-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 ein Verzeichnis abzurufen.

Eine ACL beschreibt Einzelpersonen und Gruppen, die über bestimmte Aktionen für die angegebene Datei oder das angegebene Verzeichnis verfügen oder nicht über berechtigungen verfügen. 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.

GetAccessControl(String, AccessControlSections)

Ruft ein DirectorySecurity -Objekt ab, das den angegebenen Typ von Zugriffssteuerungslisteneinträgen (Access Control List, ACL) für ein angegebenes Verzeichnis kapselt.

public:
 static System::Security::AccessControl::DirectorySecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);

public static System.Security.AccessControl.DirectorySecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);

static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.DirectorySecurity

Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As DirectorySecurity

Parameter

path

String

Der Pfad zu einem Verzeichnis, das ein DirectorySecurity-Objekt enthält, das die Informationen zur Zugriffssteuerungsliste (Access Control List, ACL) der Datei beschreibt.

includeSections

AccessControlSections

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

Gibt zurück

DirectorySecurity

Ein Objekt, das die Zugriffssteuerungsregeln für die vom path-Parameter beschriebene Datei kapselt.

Ausnahmen

ArgumentNullException

Der parameter path ist null.

IOException

Beim Öffnen des Verzeichnisses ist ein E/A-Fehler aufgetreten.

SystemException

Fehler auf Systemebene, z. B. das Verzeichnis, konnte nicht gefunden werden. Die spezifische Ausnahme kann eine Unterklasse von SystemExceptionsein.

UnauthorizedAccessException

Der path Parameter hat ein Schreibgeschütztes Verzeichnis angegeben.

-oder-

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

-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 ein Verzeichnis abzurufen.

Eine ACL beschreibt Einzelpersonen und Gruppen, die über bestimmte Aktionen für die angegebene Datei oder das angegebene Verzeichnis verfügen oder nicht über berechtigungen verfügen. 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.