Win32_Directory 类的 ChangeSecurityPermissions 方法

ChangeSecurityPermissions WMI 类方法更改对象路径中指定的逻辑目录条目文件的安全权限。 如果逻辑文件是目录，则 ChangeSecurityPermissions 是递归的，并更改该目录包含的所有文件和子目录的安全权限。 如果权限发生更改， ChangeSecurityPermissions 类将返回整数值 0 (零) ，并返回其他数字以指示错误。

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

语法

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

参数

SecurityDescriptor [in]

解析为 Win32_SecurityDescriptor 实例的表达式。 此描述符包含 Win32_PageFile实例的新安全权限。

选项 [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)

更改逻辑文件的任意 DACL。

CHANGE_SACL_SECURITY_INFORMATION (8)

(逻辑文件的 SACL) 更改系统访问控制列表。

返回值

如果权限已更改，则返回 0 (零) 的值，以及指示错误的不同数字。

Success

0

请求成功。

拒绝访问

2

访问被拒绝。

未知故障

8

发生了未指定的故障。

对象无效

9

指定的名称无效。

对象已存在

10

指定的对象已经存在。

文件系统不是 NTFS

11

文件系统不是 NTFS 文件系统。

平台而非 NT/Windows 2000

12

平台不是 Windows。

驱动器不同

13

驱动器不同。

目录不为空

14

目录不为空。

共享冲突

15

存在共享冲突。

启动文件无效

16

指定的启动文件无效。

未保留权限

17

不保留操作所需的特权。

参数无效

21

指定的参数无效。

要求

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

另请参阅

操作系统类

Win32_Directory