IOleInPlaceObject：：InPlaceDeactivate 方法 (oleidl.h)

發行項
03/01/2024

停用作用中的就地物件，並捨棄對象的復原狀態。

Syntax

HRESULT InPlaceDeactivate();

傳回值

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

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

備註

來電者的附註

使用中物件的立即容器會呼叫這個方法，以停用使用中對象並捨棄其復原狀態。

實作者的注意事項

從 IOleInPlaceObject：：InPlaceDeactivate 傳回時，對象會捨棄其復原狀態。物件應用程式不應在此呼叫之後立即關閉。相反地，它應該等候明確呼叫 IOleObject：：Close 或對象的參考計數達到零。

在停用之前，物件應用程式應該呼叫 IOleInPlaceSite：：OnUIDeactivate，讓容器有機會將其使用者介面放回框架視窗。

如果在呼叫 IOleInPlaceObject：：InPlaceDeactivate 期間仍會顯示就地使用者介面，則物件應用程式應該呼叫自己的 IOleInPlaceObject：：InPlaceDeactivate 方法來隱藏使用者介面。就地使用者介面可以在 呼叫 IOleInPlaceObject：：InPlaceDeactivate 和IOleInPlaceObject：：InPlaceDeactivate 期間選擇性地終結。但是，如果容器呼叫 IOleObject：：Close 時尚未終結使用者介面，則必須在 呼叫 IOleObject：：Close 期間終結。

在呼叫 IOleObject：：Close 期間，對象應該檢查它是否仍在作用中。如果是，它應該呼叫 IOleInPlaceObject：：InPlaceDeactivate。

規格需求

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