Método IConsolePowerSink::OnPowerBroadcast (mmc.h)
O método OnPowerBroadcast processa WM_POWERBROADCAST mensagens de notificação relacionadas ao gerenciamento de energia do computador.
Sintaxe
HRESULT OnPowerBroadcast(
[in] UINT nEvent,
[in] LPARAM lParam,
[out] LRESULT *plReturn
);
Parâmetros
[in] nEvent
O identificador de evento de transmissão de energia. O identificador é um dos valores a seguir.
PBT_APMBATTERYLOW
A bateria está fraca.
PBT_APMOEMEVENT
Ocorreu um evento definido pelo OEM.
PBT_APMPOWERSTATUSCHANGE
O power status foi alterado.
PBT_APMQUERYSUSPEND
Solicitar permissão para suspender.
PBT_APMQUERYSUSPENDFAILED
Solicitação de suspensão negada.
PBT_APMRESUMEAUTOMATIC
Operação continuando automaticamente após o evento.
PBT_APMRESUMECRITICAL
Operação retomada após suspensão crítica.
PBT_APMRESUMESUSPEND
A operação continua após a suspensão.
PBT_APMSUSPEND
O sistema está suspendendo a operação.
[in] lParam
Dados específicos da função. Para a maioria dos eventos, esse parâmetro é reservado e não é usado. No entanto, se nEvent for um dos eventos de retomada (PBT_APMRESUME*), o parâmetro lParam poderá especificar o sinalizador PBTF_APMRESUMEFROMFAILURE. Esse sinalizador indica que uma operação de suspensão falhou após a transmissão do evento PBT_APMSUSPEND.
[out] plReturn
No retorno, a resposta do snap-in ao evento de difusão. Em geral, defina *plReturn como TRUE. A exceção é quando nEvent é PBT_APMQUERYSUSPEND. Para permitir que a suspensão do computador continue em resposta ao evento PBT_APMQUERYSUSPEND, defina *plReturn como TRUE; para negar a suspensão do computador, defina *plReturn como BROADCAST_QUERY_DENY. Um snap-in que permite a suspensão do computador deve executar as preparações de suspensão necessárias antes de retornar desse método.
Retornar valor
Se tiver êxito, o valor retornado será S_OK. Outros valores retornados indicam um código de erro.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |