IConsolePowerSink::OnPowerBroadcast-Methode (mmc.h)

Die OnPowerBroadcast-Methode verarbeitet WM_POWERBROADCAST Benachrichtigungen im Zusammenhang mit der Energieverwaltung des Computers.

Syntax

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

Parameter

[in] nEvent

Der Power Broadcast-Ereignisbezeichner. Der Bezeichner ist einer der folgenden Werte.

PBT_APMBATTERYLOW

Niedriger Ladezustand des Akkus.

PBT_APMOEMEVENT

Vom OEM definiertes Ereignis ist aufgetreten.

PBT_APMPOWERSTATUSCHANGE

Power status hat sich geändert.

PBT_APMQUERYSUSPEND

Anfordern der Berechtigung zum Anhalten.

PBT_APMQUERYSUSPENDFAILED

Aussetzungsanforderung abgelehnt.

PBT_APMRESUMEAUTOMATIC

Vorgang wird nach dem Ereignis automatisch fortgesetzt.

PBT_APMRESUMECRITICAL

Der Vorgang wird nach kritischem Anhalten fortgesetzt.

PBT_APMRESUMESUSPEND

Der Vorgang wird nach dem Anhalten fortgesetzt.

PBT_APMSUSPEND

Der Systemvorgang wird angehalten.

[in] lParam

Funktionsspezifische Daten. Für die meisten Ereignisse wird dieser Parameter reserviert und nicht verwendet. Wenn nEvent jedoch eines der Resume-Ereignisse (PBT_APMRESUME*) ist, kann der lParam-Parameter das PBTF_APMRESUMEFROMFAILURE-Flag angeben. Dieses Flag gibt an, dass ein Angehaltener Vorgang fehlgeschlagen ist, nachdem das PBT_APMSUSPEND-Ereignis übertragen wurde.

[out] plReturn

Bei der Rückgabe wird die Antwort des Snap-Ins auf das Broadcastereignis angezeigt. Legen Sie *plReturn im Allgemeinen auf TRUE fest. Die Ausnahme ist , wenn nEventPBT_APMQUERYSUSPEND ist. Damit die Computersperre als Reaktion auf das PBT_APMQUERYSUSPEND-Ereignis fortgesetzt werden kann, legen Sie *plReturn auf TRUE fest. Um das Anhalten des Computers zu verweigern, legen Sie *plReturn auf BROADCAST_QUERY_DENY fest. Ein Snap-In, das eine Computeraufhängung ermöglicht, sollte die erforderlichen Vorbereitungen zur Aufhängung durchführen, bevor er von dieser Methode zurückkehrt.

Rückgabewert

Bei erfolgreicher Ausführung wird der Rückgabewert S_OK. Andere Rückgabewerte weisen auf einen Fehlercode hin.

Anforderungen

Weitere Informationen

WM_POWERBROADCAST