Método IConsolePowerSink::OnPowerBroadcast (mmc.h)
El método OnPowerBroadcast procesa WM_POWERBROADCAST mensajes de notificación relacionados con la administración de energía del equipo.
Sintaxis
HRESULT OnPowerBroadcast(
[in] UINT nEvent,
[in] LPARAM lParam,
[out] LRESULT *plReturn
);
Parámetros
[in] nEvent
Identificador de evento de difusión de energía. El identificador es uno de los valores siguientes.
PBT_APMBATTERYLOW
La energía de la batería está baja.
PBT_APMOEMEVENT
Se produjo un evento definido por OEM.
PBT_APMPOWERSTATUSCHANGE
El estado de energía ha cambiado.
PBT_APMQUERYSUSPEND
Solicitud de permiso para suspender.
PBT_APMQUERYSUSPENDFAILED
Solicitud de suspensión denegada.
PBT_APMRESUMEAUTOMATIC
Operación que se reanuda automáticamente después del evento.
PBT_APMRESUMECRITICAL
Operación que se reanuda después de la suspensión crítica.
PBT_APMRESUMESUSPEND
Operación que se reanuda después de la suspensión.
PBT_APMSUSPEND
El sistema está suspendiendo la operación.
[in] lParam
Datos específicos de la función. Para la mayoría de los eventos, este parámetro está reservado y no se usa. Sin embargo, si nEvent es uno de los eventos de reanudación (PBT_APMRESUME*), el parámetro lParam puede especificar la marca PBTF_APMRESUMEFROMFAILURE. Esta marca indica que se produjo un error en una operación de suspensión después de la difusión del evento PBT_APMSUSPEND .
[out] plReturn
A cambio, la respuesta del complemento al evento de difusión. Por lo general, establezca *plReturn en TRUE. La excepción es cuando nEvent se PBT_APMQUERYSUSPEND. Para permitir que la suspensión del equipo continúe en respuesta al evento PBT_APMQUERYSUSPEND, establezca *plReturn en TRUE; para denegar la suspensión del equipo, establezca *plReturn en BROADCAST_QUERY_DENY. Un complemento que permita la suspensión del equipo debe realizar los preparativos de suspensión necesarios antes de volver de este método.
Valor devuelto
Si se ejecuta correctamente, se S_OK el valor devuelto. Otros valores devueltos indican un código de error.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | mmc.h |