IObjectWithSite::GetSite 方法 (ocidl.h)

检索使用 SetSite 传递的最新站点。

语法

HRESULT GetSite(
  [in]  REFIID riid,
  [out] void   **ppvSite
);

参数

[in] riid

应在 ppvSite 中返回的接口指针的 IID。

[out] ppvSite

接收 riid 中请求的接口指针的指针变量的地址。 成功返回后,*ppvSite 包含请求的接口指针,指向 上次在 SetSite 中看到的站点。 返回的特定接口取决于 riid 参数。 实质上,这两个参数的作用与 QueryInterface 中的参数相同。 如果相应的接口指针可用,则对象必须在该指针上调用 AddRef ,然后才能成功返回。 如果没有可用的站点,或者不支持请求的接口,则此方法必须 *ppvSiteNULL 并返回失败代码。

返回值

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

返回代码 说明
E_FAIL
没有站点,在这种情况下*ppvSite 在返回时包含 NULL
E_NOINTERFACE
有一个站点,但它不支持 riid 请求的接口。

注解

不允许E_NOTIMPL。 实现此接口的任何对象都必须能够返回 IObjectWithSite::SetSite 中看到的最后一个站点。

要求

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

另请参阅

IObjectWithSite