Win32_CodecFile 类的 ChangeSecurityPermissions 方法
ChangeSecurityPermissionsWMI 类方法更改对象路径中指定的逻辑编解码器文件的安全权限。 如果逻辑文件是目录,则 ChangeSecurityPermissions 是递归的,并更改目录包含的所有文件和子目录的安全权限。 如果权限发生更改,ChangeSecurityPermissions 将返回 0 (零) 整数值,并返回一个不同的数字来指示错误。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息,请参阅 调用方法。
语法
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
参数
-
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) 更改系统访问控制列表。
返回值
如果权限发生更改,则返回 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 |
|
DLL |
|