CIM_DataFile 类的 ChangeSecurityPermissionsEx 方法

ChangeSecurityPermissionsEx 方法更改对象路径中指定的逻辑数据文件的安全权限, (此方法是 ChangeSecurityPermissions 方法) 的扩展版本。 如果逻辑文件实际上是一个目录,则此方法将以递归方式执行操作,从而更改该目录包含的所有文件和子目录的安全权限。

重要

DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构

本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息,请参阅 调用方法

语法

uint32 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32                   Option,
  [out]          string                   StopFileName,
  [in, optional] string                   StartFileName,
  [in, optional] boolean                  Recursive
);

参数

SecurityDescriptor [in]

指定安全信息。

注意

SECURITY_DESCRIPTOR结构中的 NULL ACL 授予无限制的访问权限。 有关无限制访问的影响的详细信息,请参阅 为新对象创建安全描述符

选项 [in]

要修改的安全权限。 例如,若要更改所有者和 DACL 安全性,请使用:

Option = 1 + 4Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1)

更改逻辑文件的所有者。

CHANGE_GROUP_SECURITY_INFORMATION (2)

更改逻辑文件的组。

CHANGE_DACL_SECURITY_INFORMATION (4)

更改逻辑文件的 ACL。

CHANGE_SACL_SECURITY_INFORMATION (8)

更改逻辑文件的系统 ACL。

StopFileName [out]

表示方法失败的文件 (或目录) 名称的字符串。 如果方法成功,此参数为 null

StartFileName [in, 可选]

表示子文件 (或目录) 用作此方法起点的字符串。 通常, StartFileName 参数是 StopFileName 参数,用于指定上一方法调用出错的文件或目录。 如果此参数为 null,则会对 ExecMethod 调用中指定的文件 (或目录) 执行操作。

如果使用 StartFileName ,则 Recursive 也必须设置为 true。

递归 [in, 可选]

如果 为 True,则该方法还会以递归方式应用于 CIM_DataFile 实例指定的目录中的文件和目录。 对于文件实例,将忽略此参数。

返回值

返回一个值 0 (零成功时) ,以及指示错误的任何其他数字。 有关其他错误代码,请参阅 WMI 错误常量WbemErrorEnum。 有关常规 HRESULT 值,请参阅 系统错误代码

Success

0

成功。

拒绝访问

2

访问被拒绝。

未知故障

8

未指定的故障。

对象无效

9

指定的对象名称无效。

对象已存在

10

对象已存在。

文件系统不是 NTFS

11

文件系统不是 NTFS。

平台而非 NT/Windows 2000

12

平台而不是 Windows。

驱动器不同

13

驱动器不同。

目录不为空

14

目录不为空。

共享冲突

15

共享冲突。

启动文件无效

16

启动文件无效。

未保留权限

17

未保留权限。

参数无效

21

参数无效。

备注

CIM_DataFile 中的 ChangeSecurityPermissionsEx 方法由 WMI 实现。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

CIM_DataFile

CIM_DataFile

WMI 任务:文件和文件夹

文件和目录访问权限常量