Directory.GetAccessControl 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回目录的 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的子类。
注解
使用 GetAccessControl 方法检索目录的访问控制列表(ACL)条目。
ACL 描述对给定文件或目录的特定操作具有或无权的个人和组。 有关详细信息,请参阅 如何:添加或删除访问控制列表项。
在 NTFS 环境中,如果用户对父文件夹具有 ListDirectory 权限,则向用户授予 ReadAttributes 和 ReadExtendedAttributes。 若要拒绝 ReadAttributes 和 ReadExtendedAttributes,请拒绝父目录上的 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的子类。
注解
使用 GetAccessControl 方法检索目录的访问控制列表(ACL)条目。
ACL 描述对给定文件或目录的特定操作具有或无权的个人和组。 有关详细信息,请参阅 如何:添加或删除访问控制列表项。
在 NTFS 环境中,如果用户对父文件夹具有 ListDirectory 权限,则向用户授予 ReadAttributes 和 ReadExtendedAttributes。 若要拒绝 ReadAttributes 和 ReadExtendedAttributes,请拒绝父目录上的 ListDirectory。