RegisterPowerSettingNotification-Funktion (winuser.h)

  • Artikel

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
DEVICE_NOTIFY_WINDOW_HANDLE
0
 Benachrichtigungen werden mithilfe WM_POWERBROADCAST Nachrichten mit dem wParam-ParameterPBT_POWERSETTINGCHANGE gesendet.
DEVICE_NOTIFY_SERVICE_HANDLE
1
 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)

Weitere Informationen

Energieverwaltungsfunktionen

Registrieren für Power Events

Nicht registrierenPowerSettingNotification