CIM_LogicalFile 类的 ChangeSecurityPermissions 方法

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

重要

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 (4)

更改逻辑文件的 ACL。

Change_Sacl_Security_Information (8)

更改逻辑文件的系统 ACL。

返回值

返回成功时值为 0，以及指示错误的任何其他数字。

Success

0

成功。

拒绝访问

2

拒绝访问。

未指定的失败

8

未指定的失败。

无效对象

9

无效对象。

对象已存在

10

对象已存在。

文件系统不是 NTFS

11

文件系统不是 NTFS。

平台不是 NT/Windows 2000

12

平台未Windows。

驱动器不相同

13

驱动器不相同。

目录不为空

14

目录不为空。

共享冲突

15

共享冲突。

启动文件无效

16

启动文件无效。

未保留的特权

17

权限未保留。

参数无效

21

参数无效。

注解

此方法当前未由 WMI 实现。 若要使用此方法，必须在自己的提供程序中实现此方法。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已更改以更正次要错误、符合 Microsoft SDK 文档标准或提供更多信息。

要求

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

另请参阅

CIM_LogicalFile

CIM_LogicalFile