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
| 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 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.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 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.
