File.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.
Ruft ein FileSecurity Objekt ab, das die Zugriffssteuerungslisteneinträge (Access Control List, ACL) für eine angegebene Datei kapselt.
Überlädt
| Name | Beschreibung |
|---|---|
| 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.FileSecurityPublic Shared Function GetAccessControl (path As String) As FileSecurityParameter
- path
- String
Der Pfad zu einer Datei, die ein FileSecurity Objekt enthält, das die Zugriffssteuerungsliste (Access Control List, ACL)-Informationen der Datei beschreibt.
Gibt zurück
Ein FileSecurity Objekt, das die Zugriffssteuerungsregeln für die vom path Parameter beschriebene Datei kapselt.
Ausnahmen
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
Der path Parameter 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 und ReadAttributes werden dem Benutzer gewährt, ReadExtendedAttributes 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 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.FileSecurityPublic Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurityParameter
- path
- String
Der Pfad zu einer Datei, die ein FileSecurity Objekt enthält, das die Zugriffssteuerungsliste (Access Control List, ACL)-Informationen 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 FileSecurity Objekt, das die Zugriffssteuerungsregeln für die vom path Parameter beschriebene Datei kapselt.
Ausnahmen
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
Der path Parameter 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 und ReadAttributes werden dem Benutzer gewährt, ReadExtendedAttributes wenn der Benutzer über Rechte für den übergeordneten Ordner verfügtListDirectory. Um das übergeordnete Verzeichnis zu verweigern ReadAttributes und ReadExtendedAttributeszu verweigern ListDirectory .
