Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 |
|---|---|
|
O parâmetro Recipient é um identificador para um serviço. Use a função CreateService ou OpenService para obter esse identificador. |
|
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 |