ISecurityInformation::SetSecurity 方法 (aclui.h)
SetSecurity 方法提供一个安全描述符,其中包含用户希望应用于安全对象的安全信息。 当用户单击“ 确定 ”或“ 应用”时,访问控制编辑器将调用此方法。
语法
HRESULT SetSecurity(
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
参数
[in] SecurityInformation
一组 SECURITY_INFORMATION 位标志,指示要设置的安全描述符的各个部分。 此参数可以是以下值的组合。
值 | 含义 |
---|---|
|
安全描述符包含对象所有者的 SID。 |
|
安全描述符包含对象的主组的 SID。 |
|
安全描述符包含对象的 DACL。 |
|
安全描述符包含对象的 SACL。 |
[in] pSecurityDescriptor
指向包含新安全信息的安全描述符的指针。 不要假定安全描述符采用 自相对 形式;它可以是 绝对的,也可以是自相对的。
返回值
如果成功,则返回S_OK。
如果发生错误,则返回非零错误代码。
注解
若要为对象生成完整的安全描述符,应用程序必须将新的安全描述符部分(由 SecurityInformation 参数定义)合并到对象的现有安全描述符中。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | aclui.h |