Win32_Directory 类的 ChangeSecurityPermissionsEx 方法

ChangeSecurityPermissionsExWMI 类方法更改对象路径中指定的目录条目文件的安全权限, (此方法是 ChangeSecurityPermissions 方法) 的扩展版本。 如果逻辑文件是目录,则此方法是递归的,并更改该目录包含的所有文件和子目录的安全权限。

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

语法

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

参数

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) 更改系统访问控制列表。

StopFileName [out]

ChangeSecurityPermissionsEx 方法失败的文件或目录的名称。 如果方法成功,此参数为 null。

StartFileName [in, 可选]

命名用作 ChangeSecurityPermissionsEx 的起点的子文件或目录。 通常, StartFileName 参数是 StopFileName 参数,用于指定上一方法调用出错的文件或目录。 如果此参数为 null,则对 ExecMethod 调用中指定的文件或目录执行操作。 此参数可选。

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

递归 [in, 可选]

如果 为 true,则所有权更改以递归方式应用于 CIM_LogicalFile 实例指定的目录中的文件和目录。 对于文件实例,递 输入参数将被忽略。 此参数可选。

返回值

如果权限已更改,则返回 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