PowerRegisterSuspendResumeNotification-Funktion (powerbase.h)

  • Artikel

Registriert, um Benachrichtigungen zu erhalten, wenn das System angehalten oder fortgesetzt wird.

Syntax

DWORD PowerRegisterSuspendResumeNotification(
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

Parameter

[in] Flags

Dieser Parameter muss DEVICE_NOTIFY_CALLBACK sein.

[in] Recipient

Dieser Parameter ist ein Zeiger auf eine DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS-Struktur . In diesem Fall lautet die Rückruffunktion DeviceNotifyCallbackRoutine. Wenn die Rückruffunktion ausgeführt wird, wird der Type-Parameter festgelegt, der den Typ des aufgetretenen Ereignisses angibt. Mögliche Werte sind PBT_APMSUSPEND, PBT_APMRESUMESUSPEND und PBT_APMRESUMEAUTOMATIC . Weitere Informationen finden Sie unter Energieverwaltungsereignisse . Der Einstellungsparameter wird nicht für Benachrichtigungen zum Anhalten/Fortsetzen verwendet.

[out] RegistrationHandle

Ein Handle für die Registrierung. Verwenden Sie dieses Handle, um die Registrierung für Benachrichtigungen aufzuheben.

Rückgabewert

Gibt ERROR_SUCCESS (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ungleich null, wenn der Aufruf fehlgeschlagen ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile powerbase.h
Bibliothek Powrprof.lib
DLL Powrprof.dll

Weitere Informationen

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

PowerUnregisterSuspendResumeNotification