IConsolePowerSink：：OnPowerBroadcast 方法 (mmc.h)

项目
03/05/2024

OnPowerBroadcast 方法处理WM_POWERBROADCAST与计算机电源管理相关的通知消息。

语法

HRESULT OnPowerBroadcast(
  [in]  UINT    nEvent,
  [in]  LPARAM  lParam,
  [out] LRESULT *plReturn
);

参数

[in] nEvent

电源广播事件标识符。标识符是以下值之一。

PBT_APMBATTERYLOW

电池电量不足。

PBT_APMOEMEVENT

发生了 OEM 定义的事件。

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。当 nEvent被PBT_APMQUERYSUSPEND时，例外。若要允许计算机挂起继续响应PBT_APMQUERYSUSPEND事件，请将 *plReturn 设置为 TRUE;若要拒绝计算机挂起，请将 *plReturn 设置为 BROADCAST_QUERY_DENY。允许计算机挂起的管理单元应在从此方法返回之前执行必要的挂起准备。

返回值

如果成功，则返回值S_OK。其他返回值指示错误代码。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	mmc.h

另请参阅

WM_POWERBROADCAST

通过