RoRegisterForApartmentShutdown 函数 (roapi.h)

注册当前单元关闭时要调用的 IApartmentShutdown 回调。

语法

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 错误代码。

注解

若要接收单元关闭通知,应用必须通过调用 RoRegisterForApartmentShutdown 函数向系统注册其单元关闭处理程序。

警告  
 
不要从 OnUninitialize 回调调用 RoRegisterForApartmentShutdown 函数。

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 roapi.h
Library RuntimeObject.lib
DLL ComBase.dll

另请参阅

IApartmentShutdown

RoUnregisterForApartmentShutdown