Compartilhar via


Função RoRegisterForApartmentShutdown (roapi.h)

Registra um retorno de chamada IApartmentShutdown a ser invocado quando o apartamento atual é desligado.

Sintaxe

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

Parâmetros

[in] callbackObject

A interface IApartmentShutdown fornecida pelo aplicativo.

[out] apartmentIdentifier

O identificador do apartamento atual.

[out] regCookie

Um cookie que você pode usar para cancelar o registro do retorno de chamada.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para receber notificações de desligamento de apartamento, seu aplicativo deve registrar seu manipulador de desligamento de apartamento com o sistema chamando a função RoRegisterForApartmentShutdown .

Aviso  
 
Não chame a função RoRegisterForApartmentShutdown do retorno de chamada OnUninitialize .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho roapi.h
Biblioteca RuntimeObject.lib
DLL ComBase.dll

Confira também

IApartmentShutdown

RoUnregisterForApartmentShutdown