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
E_FAIL
 沒有網站，在此情況下，*ppvSite 會在傳回時包含 NULL 。
E_NOINTERFACE
 有一個網站，但不支援 riid所要求的介面。

備註

不允許E_NOTIMPL。 實作此介面的任何對象都必須能夠傳回 IObjectWithSite：：SetSite 中看到的最後一個網站。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IObjectWithSite