共用方式為


IOleClientSite::GetContainer 方法 (oleidl.h)

擷取物件容器的指標。

語法

HRESULT GetContainer(
  [out] IOleContainer **ppContainer
);

參數

[out] ppContainer

接收容器物件介面指標的 IOleContainer 指標變數位址。 如果發生錯誤,實作必須將 ppContainer 設定為 NULL

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
OLE_E_NOT_SUPPORTED
用戶端月臺位於 OLE 1 容器中。
E_NOINTERFACE
容器不會實作 IOleContainer 介面。

備註

如果容器支援其內嵌對象的連結,實作 GetContainer 可讓連結用戶端列舉容器的物件,並以遞歸方式周遊內含項目階層。 此方法是選擇性的,但建議用於預期支援其內嵌物件連結的所有容器。

鏈接用戶端可以透過遞歸呼叫 GetContainer 來取得連結來源容器的指標,以周遊複合檔對象的階層;後面接著 QueryInterface 來取得容器 IOleObject 介面的指標,最後是 IOleObject::GetClientSite ,以在其容器中取得容器的用戶端網站。

不支持連結至其內嵌物件的簡單容器可能不需要實作這個方法。 相反地,他們可以傳回E_NOINTERFACE,並將 ppContainer 設定為 NULL

規格需求

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

另請參閱

IOleClientSite