RoRegisterForApartmentShutdown function (roapi.h)

Registers an IApartmentShutdown callback to be invoked when the current apartment shuts down.

Syntax

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

Parameters

[in] callbackObject

The application-supplied IApartmentShutdown interface.

[out] apartmentIdentifier

The identifier for the current apartment.

[out] regCookie

A cookie that you can use to unregister the callback.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

To receive apartment shutdown notifications, your app must register its apartment shutdown handler with the system by calling the RoRegisterForApartmentShutdown function.

Requirements

See also

IApartmentShutdown

RoUnregisterForApartmentShutdown