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

另请参阅

ISecurityInformation4