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。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
没有站点,在这种情况下*ppvSite 在返回时包含 NULL 。 |
|
有一个站点,但它不支持 riid 请求的接口。 |
注解
不允许E_NOTIMPL。 实现此接口的任何对象都必须能够返回 IObjectWithSite::SetSite 中看到的最后一个站点。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ocidl.h |