Função RegisterSuspendResumeNotification (winuser.h)

  • Artigo

Registra-se para receber notificação quando o sistema é suspenso ou retomado. Semelhante a PowerRegisterSuspendResumeNotification, mas opera no modo de usuário e pode usar um identificador de janela.

Sintaxe

HPOWERNOTIFY RegisterSuspendResumeNotification(
  [in] HANDLE hRecipient,
  [in] DWORD  Flags
);

Parâmetros

[in] hRecipient

Esse parâmetro contém parâmetros para assinar uma notificação de energia ou um identificador de janela que representa o processo de assinatura.

Se Flags for DEVICE_NOTIFY_CALLBACK, hRecipient será interpretado como um ponteiro para uma estrutura 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.

Se Flags for DEVICE_NOTIFY_WINDOW_HANDLE, hRecipient será um identificador para a janela para a qual entregar eventos.

[in] Flags

Esse parâmetro pode ser DEVICE_NOTIFY_WINDOW_HANDLE ou DEVICE_NOTIFY_CALLBACK.

Retornar valor

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

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito Valor
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 winuser.h
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-powermanagement-l1-1-0 (introduzido em Windows 8)

Confira também

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

UnregisterSuspendResumeNotification