Função RegisterPowerSettingNotification (winuser.h)
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 |
|---|---|
|
As notificações são enviadas usando mensagens WM_POWERBROADCAST com um parâmetro wParam de PBT_POWERSETTINGCHANGE. |
|
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