RegisterPowerSettingNotification-Funktion (winuser.h)
Registriert die Anwendung, um Energieeinstellungsbenachrichtigungen für das jeweilige Energieeinstellungsereignis zu erhalten.
Syntax
HPOWERNOTIFY RegisterPowerSettingNotification(
[in] HANDLE hRecipient,
[in] LPCGUID PowerSettingGuid,
[in] DWORD Flags
);
Parameter
[in] hRecipient
Handle, das angibt, wohin die Energieeinstellungsbenachrichtigungen gesendet werden sollen. Bei interaktiven Anwendungen sollte der Flags-Parameter null und der Parameter hRecipient ein Fensterhandle sein. Für Dienste sollte der Flags-Parameter eins und der hRecipient-Parameter ein SERVICE_STATUS_HANDLE sein, wie von RegisterServiceCtrlHandlerEx zurückgegeben.
[in] PowerSettingGuid
Die GUID der Energieeinstellung, für die Benachrichtigungen gesendet werden sollen. Weitere Informationen finden Sie unter Registrieren für Power Events.
[in] Flags
| Wert | Bedeutung |
|---|---|
|
Benachrichtigungen werden mithilfe WM_POWERBROADCAST Nachrichten mit dem wParam-ParameterPBT_POWERSETTINGCHANGE gesendet. |
|
Benachrichtigungen werden mit einem dwControl-Parametervon SERVICE_CONTROL_POWEREVENT und einem dwEventType von PBT_POWERSETTINGCHANGE an dieHandlerEx-Rückruffunktion gesendet. |
Rückgabewert
Gibt ein Benachrichtigungshandle zurück, um die Registrierung für Energiebenachrichtigungen aufzuheben. Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-powermanagement-l1-1-0 (eingeführt in Windows 8) |