CIM_DataFile 类的 ChangeSecurityPermissions 方法

ChangeSecurityPermissions 方法更改对象路径中指定的逻辑数据文件的安全权限。 如果逻辑文件是目录，则此方法将以递归方式执行操作，更改该目录包含的所有文件和子目录的安全权限。 此方法继承自 CIM_LogicalFile。

重要

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

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

语法

uint32 ChangeSecurityPermissions(
  [in] Win32_SecurityDescriptor SecurityDescriptor,
  [in] uint32                   Option
);

参数

SecurityDescriptor [in]

指定安全信息。

注意

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

选项 [in]

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

Option = 1 + 4

或

Option = 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。

返回值

如果成功，则返回值 0，以及指示错误的任何其他数字。 有关其他错误代码，请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值，请参阅 系统错误代码。

Success

0

成功。

拒绝访问

2

访问被拒绝。

未知故障

8

未指定的故障。

对象无效

9

对象无效。

对象已存在

10

对象已存在。

文件系统不是 NTFS

11

平台而非 NT/Windows 2000

12

平台不基于Windows NT。

驱动器不同

13

驱动器不同。

目录不为空

14

目录不为空。

共享冲突

15

共享冲突。

启动文件无效

16

启动文件无效。

未保留权限

17

未保留权限。

参数无效

21

参数无效。

备注

CIM_DataFile 中的 ChangeSecurityPermissions 方法由 WMI 实现。

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

要求

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

另请参阅

CIM_DataFile

CIM_DataFile

WMI 任务：文件和文件夹

文件和目录访问权限常量