Compartilhar via

Função PowerSettingRegisterNotification (powersetting.h)

  • Artigo

Registra-se para receber notificação quando uma configuração de energia é alterada.

Sintaxe

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

Parâmetros

[in] SettingGuid

Um GUID que representa a configuração de energia.

[in] Flags

Informações sobre o destinatário da notificação. Esse parâmetro pode usar um dos valores a seguir:

Valor Significado
DEVICE_NOTIFY_SERVICE_HANDLE
 O parâmetro Recipient é um identificador para um serviço. Use a função CreateService ou OpenService para obter esse identificador.
DEVICE_NOTIFY_CALLBACK
 O parâmetro Recipient é um ponteiro para uma função de retorno de chamada a ser chamada quando a configuração de energia é alterada. Espera-se que o destinatário nesse caso seja do tipo PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS.

[in] Recipient

Um identificador para o destinatário das notificações.

[out] RegistrationHandle

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

Retornar valor

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

Comentários

Imediatamente após o registro, o retorno de chamada será invocado com o valor atual da configuração de energia. Se o registro ocorrer enquanto a configuração de energia estiver sendo alterada, você poderá receber vários retornos de chamada; o último retorno de chamada é a atualização mais recente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho powersetting.h
Biblioteca Powrprof.lib
DLL Powrprof.dll

Confira também

GUIDs de configuração de energia

PowerSettingUnregisterNotification