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 ，然后才能成功返回。 如果没有可用的站点，或者不支持请求的接口，则此方法必须 *ppvSite 为 NULL 并返回失败代码。

返回值

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

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

注解

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

要求

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

另请参阅

IObjectWithSite