RegisterSuspendResumeNotification-Funktion (winuser.h)

  • Artikel

Registriert, um Benachrichtigungen zu erhalten, wenn das System angehalten oder fortgesetzt wird. Ähnlich wie PowerRegisterSuspendResumeNotification, arbeitet jedoch im Benutzermodus und kann ein Fensterhandle verwenden.

Syntax

HPOWERNOTIFY RegisterSuspendResumeNotification(
  [in] HANDLE hRecipient,
  [in] DWORD  Flags
);

Parameter

[in] hRecipient

Dieser Parameter enthält Parameter zum Abonnieren einer Energiebenachrichtigung oder eines Fensterhandles, das den abonnementenden Prozess darstellt.

Wenn FlagsDEVICE_NOTIFY_CALLBACK ist, wird hRecipient als Zeiger auf eine DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS-Struktur interpretiert. 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.

Wenn FlagsDEVICE_NOTIFY_WINDOW_HANDLE ist, ist hRecipient ein Handle für das Fenster, an das Ereignisse übermittelt werden sollen.

[in] Flags

Dieser Parameter kann DEVICE_NOTIFY_WINDOW_HANDLE oder DEVICE_NOTIFY_CALLBACK sein.

Rückgabewert

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

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-powermanagement-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

Aufheben der RegistrierungSuspendResumeNotification