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
| 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.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 parameter path 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 SystemExceptionsein.
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.
Gilt für:
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.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, die den Typ der empfangenen Zugriffssteuerungslisteninformationen (Access Control List, ACL) angibt.
Gibt zurück
Ein Objekt, das die Zugriffssteuerungsregeln für die vom path-Parameter beschriebene Datei kapselt.
Ausnahmen
Der parameter path 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 SystemExceptionsein.
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.
