ISecurityInformation4::GetSecondarySecurity 方法 (aclui.h)
GetSecondarySecurity 方法返回可能影响资源访问的其他安全上下文。
语法
HRESULT GetSecondarySecurity(
[out] PSECURITY_OBJECT *pSecurityObjects,
[out] PULONG pSecurityObjectCount
);
参数
[out] pSecurityObjects
SECURITY_OBJECT结构的数组,这些结构包含与成功时设置的资源关联的辅助安全对象。 数组归调用方所有,并使用 LocalFree 函数释放。 pwszName 成员也是使用 LocalFree 释放的。 如果SECURITY_OBJECT结构的 cbData 或 cbData2 成员不为零,则调用方必须使用 LocalFree 释放相应的 pData 或 pData2。 如果其中任一成员为零,则相应的 pData 和 pData2 成员由资源管理器拥有,并且必须保持有效,直到 EditSecurity 函数返回
[out] pSecurityObjectCount
pSecurityObjects 参数中成功时设置的安全对象数。
返回值
如果该方法成功,则返回 S_OK。
如果方法失败,它将返回错误代码。 有关常见错误代码的列表,请参阅 常见 HRESULT 值。
注解
资源管理器不需要返回 fWellKnown 成员设置为 TRUE 且 Id 成员设置为 SECURITY_OBJECT_ID_OBJECT_SD、SECURITY_OBJECT_ID_CENTRAL_POLICY 或 SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE 的辅助对象。 调用 ComputeEffectivePermissionWithSecondarySecurity 时,访问控制编辑器将提供具有这些 ID 的安全对象。
返回的安全对象的解释与 ComputeEffectivePermissionWithSecondarySecurity 的实现相关联。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | aclui.h |