IOleObject::GetClientSite 方法 (oleidl.h)
擷取內嵌物件用戶端月臺的指標。
語法
HRESULT GetClientSite(
[out] IOleClientSite **ppClientSite
);
參數
[out] ppClientSite
接收物件用戶端月臺介面指標的 IOleClientSite 指標變數位址。 如果物件還不知道其用戶端網站,或發生錯誤, 則必須將 ppClientSite 設定為 NULL。 每次物件收到 IOleObject::GetClientSite 的呼叫時,它必須增加 ppClientSite 上的參考計數。 呼叫者必須負責在使用ppClientSite完成時呼叫 Release。
傳回值
此方法會在成功時傳回S_OK。
備註
鏈接用戶端最常呼叫 IOleObject::GetClientSite 方法,並搭配 IOleClientSite::GetContainer 方法來周遊巢狀物件的階層。 鏈接用戶端會呼叫 IOleObject::GetClientSite ,以取得連結來源用戶端網站的指標。 客戶端接著會呼叫 IOleClientSite::GetContainer ,以取得連結來源容器的指標。 最後,用戶端會呼叫 QueryInterface 來取得 IOleObject 和 IOleObject::GetClientSite,以在其容器內取得容器的用戶端網站。 藉由重複這個呼叫序列,呼叫端最終可以擷取主要容器的指標,其中所有其他物件都是巢狀的。
來電者的附註
如果內嵌物件尚未收到其用戶端月臺的通知,傳回的用戶端月臺指標將會是 NULL 。 當容器將 NULL 用戶端網站指標傳遞至其中一個物件建立協助程式函式,但尚未呼叫 IOleObject::SetClientSite 初始化物件時,這會是新載入或建立物件的案例。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |