IConsolePowerSink：：OnPowerBroadcast 方法 (mmc.h)

發行項
02/29/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。例外狀況是 nEventPBT_APMQUERYSUSPEND。若要允許計算機暫停繼續回應PBT_APMQUERYSUSPEND事件，請將 *plReturn 設定為 TRUE;若要拒絕計算機暫停，請將 *plReturn 設定為 BROADCAST_QUERY_DENY。允許計算機暫停的嵌入式管理單元應該先執行必要的暫停準備，再從此方法傳回。

傳回值

如果成功，則會S_OK傳回值。其他傳回值表示錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	mmc.h

另請參閱

WM_POWERBROADCAST

共用方式為