IOleClientSite：：GetContainer 方法 (oleidl.h)

  • 项目

检索指向对象的容器的指针。

语法

HRESULT GetContainer(
  [out] IOleContainer **ppContainer
);

参数

[out] ppContainer

接收指向容器对象的接口指针的 IOleContainer 指针变量的地址。 如果发生错误，实现必须将 ppContainer 设置为 NULL。

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
OLE_E_NOT_SUPPORTED
 客户端站点位于 OLE 1 容器中。
E_NOINTERFACE
 容器不实现 IOleContainer 接口。

注解

如果容器支持指向其嵌入对象的链接，则实现 GetContainer 可让链接客户端枚举容器的对象，并递归遍历包含层次结构。 此方法是可选的，但建议用于所有希望支持其嵌入对象的链接的容器。

链接客户端可以通过以递归方式调用 GetContainer 来获取指向链接源容器的指针，遍历复合文档对象的层次结构;后跟 QueryInterface 获取指向容器的 IOleObject 接口的指针，最后，获取指向其容器中的容器的客户端站点的 IOleObject：：GetClientSite 。

不支持嵌入对象链接的简单容器可能不需要实现此方法。 相反，他们可以返回E_NOINTERFACE并将 ppContainer 设置为 NULL。

要求

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

另请参阅

IOleClientSite