Compartilhar via


Função PowerUnregisterFromEffectivePowerModeNotifications (powersetting.h)

Cancela o registro de notificações de alteração efetivas do modo de energia. Essa função deve ser chamada do código de limpeza e aguardará a conclusão de todos os retornos de chamada antes de cancelar o registro.

Sintaxe

HRESULT PowerUnregisterFromEffectivePowerModeNotifications(
  PVOID RegistrationHandle
);

Parâmetros

RegistrationHandle

O identificador correspondente a um único registro de modo de energia. Esse identificador deveria ter sido salvo pelo chamador após a chamada para PowerRegisterForEffectivePowerModeNotifications e passado aqui.

Retornar valor

Retornará S_OK (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 10, versão 1809 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho powersetting.h
Biblioteca Powrprof.lib
DLL Powrprof.dll

Confira também

PowerRegisterForEffectivePowerModeNotifications