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

另请参阅

IOleObject

IOleObject：：SetClientSite