RoRegisterForApartmentShutdown 函數 (roapi.h)

註冊一個 IApartmentShutdown 回撥,當當前公寓關閉時會被呼叫。

Syntax

HRESULT RoRegisterForApartmentShutdown(
  [in]  IApartmentShutdown                     *callbackObject,
  [out] UINT64                                 *apartmentIdentifier,
  [out] APARTMENT_SHUTDOWN_REGISTRATION_COOKIE *regCookie
);

參數

[in] callbackObject

應用程式提供的 IApartmentShutdown 介面。

[out] apartmentIdentifier

目前公寓的識別碼。

[out] regCookie

一個可以用來取消註冊回撥的 cookie。

返回值

如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

Remarks

實作 IApartmentShutdown 介面的物件必須具備敏捷性。

OnUninitialize 回撥是在即將關閉的公寓情境中呼叫的。

呼叫結束後會自動取消註冊。

Warning  
 
不要從 OnUninitialize 回調呼叫 RoRegisterForApartmentShutdown 函式。

Requirements

需求 Value
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平臺 Windows
Header 羅阿皮.h
Library RuntimeObject.lib 的檔案
DLL ComBase.dll

也請參閱

IApartmentShutdown

RoUnregisterForApartmentShutdown