RegisterSuspendResumeNotification-Funktion (winuser.h)
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