Função RegisterAppStateChangeNotification (appnotify.h)

  • Artigo

Permite que um aplicativo registre uma função de retorno de chamada por meio da qual ele pode ser notificado de que sua biblioteca está entrando ou saindo de um estado suspenso. O aplicativo pode usar essas informações para executar todas as operações necessárias, como preservar o estado, que devem ser executadas nesse ponto.

Sintaxe

APICONTRACT ULONG RegisterAppStateChangeNotification(
  [in]           PAPPSTATE_CHANGE_ROUTINE Routine,
  [in, optional] PVOID                    Context,
  [out]          PAPPSTATE_REGISTRATION   *Registration
);

Parâmetros

[in] Routine

Um ponteiro para uma função de retorno de chamada que é chamada quando o aplicativo entra ou sai do estado suspenso. Consulte PAPPSTATE_CHANGE_ROUTINE para obter mais detalhes sobre essa função.

[in, optional] Context

Informações de contexto específicas do aplicativo que o aplicativo usa ao entrar ou sair de um estado suspenso. Normalmente, esse é um ponteiro "this".

[out] Registration

Quando essa função retorna com êxito, esse parâmetro recebe o endereço de um ponteiro para um valor que pode ser usado para identificar o registro. Armazene esse valor para usar com UnregisterAppStateChangeNotification.

Retornar valor

Um código de status padrão do Win32.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho appnotify.h
Biblioteca Appnotify.lib
DLL Twinapi.core.dll

Confira também

UnregisterAppStateChangeNotification