Win32_CodecFile 类的 ChangeSecurityPermissionsEx 方法

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

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

语法

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

parameters

SecurityDescriptor [in]

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

选项 [in]

要修改的实际安全特权。 例如，若要更改所有者和自由访问控制列表 (DACL) 安全性，请使用以下命令：

Option = 1 + 4

-或-

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1 (0x1) )

更改逻辑文件的所有者。

CHANGE_GROUP_SECURITY_INFORMATION (2 (0x2) )

更改逻辑文件的组。

CHANGE_DACL_SECURITY_INFORMATION (4 (0x4) )

(逻辑文件的 DACL) 更改任意访问控制列表。

CHANGE_SACL_SECURITY_INFORMATION (8 (0x8) )

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

StopFileName [out]

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

StartFileName [in， 可选]

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

递归 [in， 可选]

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

返回值

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

Success

0

请求成功。

拒绝访问

2

访问被拒绝。

未知故障

8

发生了未指定的故障。

对象无效

9

指定的名称无效。

对象已存在

10

指定的对象已经存在。

文件系统不是 NTFS

11

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

平台而非 NT/Windows 2000

12

平台不是Windows NT或 Windows 2000。

驱动器不同

13

驱动器不同。

目录不为空

14

目录不为空。

共享冲突

15

存在共享冲突。

启动文件无效

16

指定的启动文件无效。

未保留权限

17

不保留操作所需的特权。

参数无效

21

指定的参数无效。

要求

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

另请参阅

操作系统类

Win32_CodecFile