Метод IConsolePowerSink::OnPowerBroadcast (mmc.h)
Метод OnPowerBroadcast обрабатывает WM_POWERBROADCAST уведомления, связанные с управлением питанием компьютера.
Синтаксис
HRESULT OnPowerBroadcast(
[in] UINT nEvent,
[in] LPARAM lParam,
[out] LRESULT *plReturn
);
Параметры
[in] nEvent
Идентификатор события трансляции питания. Идентификатор является одним из следующих значений.
PBT_APMBATTERYLOW
Низкий уровень заряда батареи.
PBT_APMOEMEVENT
Произошло событие, определенное изготовителем оборудования.
PBT_APMPOWERSTATUSCHANGE
Состояние питания изменилось.
PBT_APMQUERYSUSPEND
Запрос разрешения на приостановку.
PBT_APMQUERYSUSPENDFAILED
Запрос на приостановку отклонен.
PBT_APMRESUMEAUTOMATIC
Автоматическое возобновление операции после события.
PBT_APMRESUMECRITICAL
Операция возобновления после критической приостановки.
PBT_APMRESUMESUSPEND
Операция возобновления после приостановки.
PBT_APMSUSPEND
Система приостанавливает работу.
[in] lParam
Данные, относящиеся к функциям. Для большинства событий этот параметр зарезервирован и не используется. Однако если nEvent является одним из событий возобновления (PBT_APMRESUME*), параметр lParam может указать флаг PBTF_APMRESUMEFROMFAILURE. Этот флаг указывает, что операция приостановки завершилась сбоем после трансляции события PBT_APMSUSPEND .
[out] plReturn
По возвращении — ответ оснастки на трансляцию. Как правило, присвойте параметру *plReturn значение TRUE. Исключением является PBT_APMQUERYSUSPEND nEvent. Чтобы приостановить работу компьютера в ответ на событие PBT_APMQUERYSUSPEND, задайте для параметра *plReturn значение TRUE; Чтобы запретить приостановку компьютера, установите для *plReturn значение BROADCAST_QUERY_DENY. Оснастка, допускающая приостановку компьютера, должна выполнять необходимую подготовку приостановки перед возвращением из этого метода.
Возвращаемое значение
В случае успешного выполнения возвращаемое значение будет S_OK. Другие возвращаемые значения указывают на код ошибки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |