Directory.GetAccessControl 方法

定义

返回目录的 Windows 访问控制列表(ACL)。

重载

GetAccessControl(String)

获取一个 DirectorySecurity 对象,该对象封装指定目录的访问控制列表(ACL)条目。

GetAccessControl(String, AccessControlSections)

获取一个 DirectorySecurity 对象,该对象封装指定目录的指定访问控制列表 (ACL) 条目的类型。

GetAccessControl(String)

获取一个 DirectorySecurity 对象,该对象封装指定目录的访问控制列表(ACL)条目。

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

参数

path
String

包含描述文件的访问控制列表(ACL)信息的 DirectorySecurity 对象的目录的路径。

返回

一个对象,该对象封装 path 参数描述的文件的访问控制规则。

例外

path 参数 null

打开目录时出现 I/O 错误。

出现系统级错误,例如找不到目录。 特定异常可能是 SystemException的子类。

path 参数指定了只读目录。

-或-

当前平台上不支持此操作。

-或-

调用方没有所需的权限。

注解

使用 GetAccessControl 方法检索目录的访问控制列表(ACL)条目。

ACL 描述对给定文件或目录的特定操作具有或无权的个人和组。 有关详细信息,请参阅 如何:添加或删除访问控制列表项

在 NTFS 环境中,如果用户对父文件夹具有 ListDirectory 权限,则向用户授予 ReadAttributesReadExtendedAttributes。 若要拒绝 ReadAttributesReadExtendedAttributes,请拒绝父目录上的 ListDirectory

适用于

GetAccessControl(String, AccessControlSections)

获取一个 DirectorySecurity 对象,该对象封装指定目录的指定访问控制列表 (ACL) 条目的类型。

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

参数

path
String

包含描述文件的访问控制列表(ACL)信息的 DirectorySecurity 对象的目录的路径。

includeSections
AccessControlSections

指定要接收的访问控制列表(ACL)信息的 AccessControlSections 值之一。

返回

一个对象,该对象封装 path 参数描述的文件的访问控制规则。

例外

path 参数 null

打开目录时出现 I/O 错误。

出现系统级错误,例如找不到目录。 特定异常可能是 SystemException的子类。

path 参数指定了只读目录。

-或-

当前平台上不支持此操作。

-或-

调用方没有所需的权限。

注解

使用 GetAccessControl 方法检索目录的访问控制列表(ACL)条目。

ACL 描述对给定文件或目录的特定操作具有或无权的个人和组。 有关详细信息,请参阅 如何:添加或删除访问控制列表项

在 NTFS 环境中,如果用户对父文件夹具有 ListDirectory 权限,则向用户授予 ReadAttributesReadExtendedAttributes。 若要拒绝 ReadAttributesReadExtendedAttributes,请拒绝父目录上的 ListDirectory

适用于