File.GetAccessControl 方法

定义

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

重载

GetAccessControl(String)

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

GetAccessControl(String, AccessControlSections)

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

GetAccessControl(String)

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

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.FileSecurity
Public Shared Function GetAccessControl (path As String) As FileSecurity

参数

path
String

文件的路径,其中包含描述文件的访问控制列表(ACL)信息的 FileSecurity 对象。

返回

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

例外

打开文件时出现 I/O 错误。

path 参数 null

找不到该文件。

path 参数指定了只读文件。

-或-

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

-或-

path 参数指定了目录。

-或-

调用方没有所需的权限。

注解

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

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

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

适用于

GetAccessControl(String, AccessControlSections)

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

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.FileSecurity
Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

参数

path
String

文件的路径,其中包含描述文件的访问控制列表(ACL)信息的 FileSecurity 对象。

includeSections
AccessControlSections

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

返回

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

例外

打开文件时出现 I/O 错误。

path 参数 null

找不到该文件。

path 参数指定了只读文件。

-或-

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

-或-

path 参数指定了目录。

-或-

调用方没有所需的权限。

注解

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

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

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

适用于