IOleClientSite::GetContainer 方法 (oleidl.h)
擷取物件容器的指標。
語法
HRESULT GetContainer(
[out] IOleContainer **ppContainer
);
參數
[out] ppContainer
接收容器物件介面指標的 IOleContainer 指標變數位址。 如果發生錯誤,實作必須將 ppContainer 設定為 NULL。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
用戶端月臺位於 OLE 1 容器中。 |
|
容器不會實作 IOleContainer 介面。 |
備註
如果容器支援其內嵌對象的連結,實作 GetContainer 可讓連結用戶端列舉容器的物件,並以遞歸方式周遊內含項目階層。 此方法是選擇性的,但建議用於預期支援其內嵌物件連結的所有容器。
鏈接用戶端可以透過遞歸呼叫 GetContainer 來取得連結來源容器的指標,以周遊複合檔對象的階層;後面接著 QueryInterface 來取得容器 IOleObject 介面的指標,最後是 IOleObject::GetClientSite ,以在其容器中取得容器的用戶端網站。
不支持連結至其內嵌物件的簡單容器可能不需要實作這個方法。 相反地,他們可以傳回E_NOINTERFACE,並將 ppContainer 設定為 NULL。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |