ISecurityInformation::SetSecurity 方法 (aclui.h)

SetSecurity 方法提供一个安全描述符,其中包含用户希望应用于安全对象的安全信息。 当用户单击“ 确定 ”或“ 应用”时,访问控制编辑器将调用此方法。

语法

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

参数

[in] SecurityInformation

一组 SECURITY_INFORMATION 位标志,指示要设置的安全描述符的各个部分。 此参数可以是以下值的组合。

含义
OWNER_SECURITY_INFORMATION
安全描述符包含对象所有者的 SID。
GROUP_SECURITY_INFORMATION
安全描述符包含对象的主组的 SID。
DACL_SECURITY_INFORMATION
安全描述符包含对象的 DACL。
SACL_SECURITY_INFORMATION
安全描述符包含对象的 SACL。

[in] pSecurityDescriptor

指向包含新安全信息的安全描述符的指针。 不要假定安全描述符采用 自相对 形式;它可以是 绝对的,也可以是自相对的

返回值

如果成功,则返回S_OK。

如果发生错误,则返回非零错误代码。

注解

若要为对象生成完整的安全描述符,应用程序必须将新的安全描述符部分(由 SecurityInformation 参数定义)合并到对象的现有安全描述符中。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 aclui.h

另请参阅

访问控制编辑器

访问控制编辑器函数

ISecurityInformation

SECURITY_INFORMATION