PowerRegisterSuspendResumeNotification-Funktion (powerbase.h)
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