IConsolePowerSink::OnPowerBroadcast メソッド (mmc.h)
OnPowerBroadcast メソッドは、コンピューターの電源管理に関連WM_POWERBROADCAST通知メッセージを処理します。
構文
HRESULT OnPowerBroadcast(
[in] UINT nEvent,
[in] LPARAM lParam,
[out] LRESULT *plReturn
);
パラメーター
[in] nEvent
Power Broadcast イベント識別子。 識別子は、次のいずれかの値です。
PBT_APMBATTERYLOW
バッテリの電力が低下しています。
PBT_APMOEMEVENT
OEM で定義されたイベントが発生しました。
PBT_APMPOWERSTATUSCHANGE
電源の状態が変更されました。
PBT_APMQUERYSUSPEND
中断するアクセス許可を要求します。
PBT_APMQUERYSUSPENDFAILED
中断要求が拒否されました。
PBT_APMRESUMEAUTOMATIC
イベントの後に自動的に再開する操作。
PBT_APMRESUMECRITICAL
重大な中断後に再開する操作。
PBT_APMRESUMESUSPEND
中断後に再開する操作。
PBT_APMSUSPEND
システムが操作を中断しています。
[in] lParam
関数固有のデータ。 ほとんどのイベントでは、このパラメーターは予約されており、使用されません。 ただし、 nEvent が再開イベントの 1 つである場合 (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 |