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。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
沒有網站,在此情況下,*ppvSite 會在傳回時包含 NULL 。 |
|
有一個網站,但不支援 riid所要求的介面。 |
備註
不允許E_NOTIMPL。 實作此介面的任何對象都必須能夠傳回 IObjectWithSite::SetSite 中看到的最後一個網站。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |