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 |
|
| DLL |
|