IOleObject::GetClientSite 方法 (oleidl.h)

检索指向嵌入对象的客户端站点的指针。

语法

HRESULT GetClientSite(
  [out] IOleClientSite **ppClientSite
);

参数

[out] ppClientSite

接收指向对象的客户端站点的接口指针的 IOleClientSite 指针变量的地址。 如果对象尚不知道其客户端站点,或者发生错误,则必须将 ppClientSite 设置为 NULL。 每次对象收到对 IOleObject::GetClientSite 的调用时,它都必须增加 ppClientSite 上的引用计数。 调用方负责在使用 ppClientSite 时调用 Release

返回值

此方法在成功时返回S_OK。

注解

链接客户端通常结合 IOleClientSite::GetContainer 方法调用 IOleObject::GetClientSite 方法,以遍历嵌套对象的层次结构。 链接客户端调用 IOleObject::GetClientSite 以获取指向链接源客户端站点的指针。 然后,客户端调用 IOleClientSite::GetContainer 以获取指向链接源容器的指针。 最后,客户端调用 QueryInterface 来获取 IOleObjectIOleObject::GetClientSite ,以在其容器中获取容器的客户端站点。 通过重复此调用序列,调用方最终可以检索指向主容器的指针,其中嵌套了所有其他对象。

调用方备注

如果尚未通知嵌入对象其客户端站点,则返回的客户端站点指针将为 NULL 。 当容器将 NULL 客户端站点指针传递到对象创建帮助程序函数之一,但在初始化对象时尚未调用 IOleObject::SetClientSite 时,新加载或创建的对象将会出现这种情况。

要求

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

另请参阅

IOleObject

IOleObject::SetClientSite