IOleObject：：SetClientSite 方法 (oleidl.h)

發行項
03/05/2024

通知內嵌物件在其容器內的顯示位置，稱為「用戶端網站」。

語法

HRESULT SetClientSite(
  [in] IOleClientSite *pClientSite
);

參數

[in] pClientSite

容器應用程式用戶端網站上 IOleClientSite 介面的指標。

傳回值

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

傳回碼	Description
E_UNEXPECTED	發生意外錯誤。

備註

在複合檔中，每個內嵌物件都有自己的用戶端網站 - 顯示的位置，以及它接收其記憶體、使用者介面和其他資源的相關信息。 IOleObject：：SetClientSite 是唯一可讓內嵌物件取得其用戶端月臺指標的方法。

來電者的附註

容器可以在物件建立時通知其用戶端月臺的物件，或之後在初始化物件時通知物件。

建立或載入物件時，容器可能會將用戶端站臺指標 (與其他) 自變數一起傳遞至下列其中一個協助程式函式：OleCreate、OleCreateFromFile、OleCreateFromData 或 OleLoad。這些協助程式函式會載入新物件的物件處理程式，並代表容器呼叫 IOleObject：：SetClientSite ，再傳回新物件的指標。

傳遞用戶端月臺指標會通知對象處理程式用戶端月臺已準備好處理要求。如果客戶端網站不太可能在載入處理程式之後立即就緒，您可能會希望容器將 NULL 用戶端月臺指標傳遞至協助程式函式。 NULL 指標表示沒有可用的用戶端網站，因此會延遲通知用戶端月臺的物件處理程式，直到物件初始化為止。為了回應，協助程式函式會傳回物件的指標，但在收到該指標時，容器必須呼叫 IOleObject：：SetClientSite 作為初始化新物件的一部分。

實作者的注意事項

實作只包含遞增參考計數，以及儲存用戶端月臺的指標。

規格需求

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