Função RegisterPowerSettingNotification (winuser.h)

Artigo
08/27/2023

Registra o aplicativo para receber notificações de configuração de energia para o evento de configuração de energia específico.

Sintaxe

HPOWERNOTIFY RegisterPowerSettingNotification(
  [in] HANDLE  hRecipient,
  [in] LPCGUID PowerSettingGuid,
  [in] DWORD   Flags
);

Parâmetros

[in] hRecipient

Identificador que indica para onde as notificações de configuração de energia devem ser enviadas. Para aplicativos interativos , o parâmetro Flags deve ser zero e o parâmetro hRecipient deve ser um identificador de janela. Para serviços, o parâmetro Flags deve ser um e o parâmetro hRecipient deve ser um SERVICE_STATUS_HANDLE conforme retornado de RegisterServiceCtrlHandlerEx.

[in] PowerSettingGuid

O GUID da configuração de energia para a qual as notificações devem ser enviadas. Para obter mais informações, consulte Registrando-se para eventos de energia.

[in] Flags

Valor	Significado
DEVICE_NOTIFY_WINDOW_HANDLE 0	As notificações são enviadas usando mensagens WM_POWERBROADCAST com um parâmetro wParam de PBT_POWERSETTINGCHANGE.
DEVICE_NOTIFY_SERVICE_HANDLE 1	As notificações são enviadas para a função de retorno de chamada HandlerEx com um parâmetro dwControl de SERVICE_CONTROL_POWEREVENT e um dwEventType de PBT_POWERSETTINGCHANGE.

Valor retornado

Retorna um identificador de notificação para cancelar o registro de notificações de energia. Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-powermanagement-l1-1-0 (introduzido no Windows 8)

Confira também

Funções de gerenciamento de energia

Registrando-se para eventos de energia

UnregisterPowerSettingNotification

Share via