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 来获取 IOleObject 和 IOleObject::GetClientSite ,以在其容器中获取容器的客户端站点。 通过重复此调用序列,调用方最终可以检索指向主容器的指针,其中嵌套了所有其他对象。
调用方备注
如果尚未通知嵌入对象其客户端站点,则返回的客户端站点指针将为 NULL 。 当容器将 NULL 客户端站点指针传递到对象创建帮助程序函数之一,但在初始化对象时尚未调用 IOleObject::SetClientSite 时,新加载或创建的对象将会出现这种情况。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oleidl.h |