Función RoRegisterForApartmentShutdown (roapi.h)

Registra una devolución de llamada IApartmentShutdown que se invocará cuando el apartamento actual se apague.

Syntax

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

Parameters

[in] callbackObject

Interfaz IApartmentShutdown proporcionada por la aplicación.

[out] apartmentIdentifier

Identificador del apartamento actual.

[out] regCookie

Cookie que puede usar para anular el registro de la devolución de llamada.

Valor de retorno

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Remarks

El objeto que implementa la interfaz IApartmentShutdown debe ser ágil.

La devolución de llamada OnUninitialize se llama en el contexto del apartamento que se cierra.

La devolución de llamada se anula automáticamente el registro después de invocarla.

Advertencia  
 
No llame a la función RoRegisterForApartmentShutdown desde la devolución de llamada OnUninitialize .

Requirements

Requirement Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
Header roapi.h
Library RuntimeObject.lib
DLL de ComBase.dll

Consulte también

IApartmentShutdown

RoUnregisterForApartmentShutdown

  • Se actualizó por última vez el