RoRegisterForApartmentShutdown 函式 (roapi.h)

註冊在目前 Apartment 關閉時要叫用的 IApartmentShutdown 回呼。

語法

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

參數

[in] callbackObject

應用程式提供的 IApartmentShutdown 介面。

[out] apartmentIdentifier

目前 Apartment 的標識碼。

[out] regCookie

可用來取消註冊回呼的 Cookie。

傳回值

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

備註

若要接收 Apartment 關機通知,您的應用程式必須呼叫 RoRegisterForApartmentShutdown 函式,向系統註冊其 Apartment 關機處理程式。

警告  
 
請勿從 OnUninitialize 回呼呼叫 RoRegisterForApartmentShutdown 函式。

規格需求

需求
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 roapi.h
程式庫 RuntimeObject.lib
Dll ComBase.dll

另請參閱

IApartmentShutdown

RoUnregisterForApartmentShutdown