Função PowerRegisterSuspendResumeNotification (powerbase.h)

Artigo
08/25/2023

Registra-se para receber notificação quando o sistema é suspenso ou retomado.

Sintaxe

DWORD PowerRegisterSuspendResumeNotification(
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

Parâmetros

[in] Flags

Esse parâmetro deve ser DEVICE_NOTIFY_CALLBACK.

[in] Recipient

Esse parâmetro é um ponteiro para uma estrutura de DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS . Nesse caso, a função de retorno de chamada é DeviceNotifyCallbackRoutine. Quando a função retorno de chamada é executada, o parâmetro Type é definido indicando o tipo de evento que ocorreu. Os valores possíveis incluem PBT_APMSUSPEND, PBT_APMRESUMESUSPEND e PBT_APMRESUMEAUTOMATIC – consulte Eventos de Gerenciamento de Energia para obter mais informações. O parâmetro Setting não é usado com notificações de suspensão/retomada.

[out] RegistrationHandle

Um identificador para o registro. Use esse identificador para cancelar o registro de notificações.

Valor retornado

Retornará ERROR_SUCCESS (zero) se a chamada tiver sido bem-sucedida e um valor diferente de zero se a chamada falhar.

Requisitos


Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	powerbase.h
Biblioteca	Powrprof.lib
DLL	Powrprof.dll

Confira também

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

PowerUnregisterSuspendResumeNotification

Compartilhar via