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

另請參閱

IOleObject

IOleObject：：SetClientSite