Directory.GetAccessControl Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Windows Zugriffssteuerungsliste (Access Control List, ACL) für ein Verzeichnis zurück.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 der Zugriffssteuerungsliste (Access Control List, ACL)-Einträge 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.DirectorySecurityPublic Shared Function GetAccessControl (path As String) As DirectorySecurityParameter
- 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
Ein Objekt, das die Zugriffssteuerungsregeln für die vom path Parameter beschriebene Datei kapselt.
Ausnahmen
Der path Parameter ist null.
Beim Öffnen des Verzeichnisses ist ein E/A-Fehler aufgetreten.
Fehler auf Systemebene, z. B. das Verzeichnis, konnte nicht gefunden werden. Die spezifische Ausnahme kann eine Unterklasse von SystemException.
Der path Parameter hat ein Verzeichnis angegeben, das schreibgeschützt ist.
-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 Zugriffssteuerungslisteneinträge (Access Control List, ACL) 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 und ReadExtendedAttributes werden dem Benutzer gewährt, ReadAttributes wenn der Benutzer über Rechte für den übergeordneten Ordner verfügtListDirectory. Um das übergeordnete Verzeichnis zu verweigern ReadAttributes und ReadExtendedAttributeszu verweigern ListDirectory .
Gilt für:
GetAccessControl(String, AccessControlSections)
Ruft ein DirectorySecurity Objekt ab, das den angegebenen Typ der Zugriffssteuerungsliste (Access Control List, ACL)-Einträge 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.DirectorySecurityPublic Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As DirectorySecurityParameter
- 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, der den Typ der zu empfangenden Zugriffssteuerungsliste (Access Control List, ACL) angibt.
Gibt zurück
Ein Objekt, das die Zugriffssteuerungsregeln für die vom path Parameter beschriebene Datei kapselt.
Ausnahmen
Der path Parameter ist null.
Beim Öffnen des Verzeichnisses ist ein E/A-Fehler aufgetreten.
Fehler auf Systemebene, z. B. das Verzeichnis, konnte nicht gefunden werden. Die spezifische Ausnahme kann eine Unterklasse von SystemException.
Der path Parameter hat ein Verzeichnis angegeben, das schreibgeschützt ist.
-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 Zugriffssteuerungslisteneinträge (Access Control List, ACL) 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 und ReadExtendedAttributes werden dem Benutzer gewährt, ReadAttributes wenn der Benutzer über Rechte für den übergeordneten Ordner verfügtListDirectory. Um das übergeordnete Verzeichnis zu verweigern ReadAttributes und ReadExtendedAttributeszu verweigern ListDirectory .