PowerSettingRegisterNotification-Funktion (powersetting.h)

Artikel
03/04/2024

Registriert sich, um Benachrichtigungen zu erhalten, wenn sich eine Energieeinstellung ändert.

Syntax

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

Parameter

[in] SettingGuid

Eine GUID, die die Energieeinstellung darstellt.

[in] Flags

Informationen zum Empfänger der Benachrichtigung. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
DEVICE_NOTIFY_SERVICE_HANDLE	Der Recipient-Parameter ist ein Handle für einen Dienst. Verwenden Sie die CreateService - oder OpenService-Funktion , um dieses Handle abzurufen.
DEVICE_NOTIFY_CALLBACK	Der Recipient-Parameter ist ein Zeiger auf eine Rückruffunktion, die aufgerufen werden soll, wenn sich die Energieeinstellung ändert. In diesem Fall wird erwartet, dass der Empfänger vom Typ PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS ist.

[in] Recipient

Ein Handle für den Empfänger der Benachrichtigungen.

[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 ohne Zero, wenn der Aufruf fehlgeschlagen ist.

Hinweise

Unmittelbar nach der Registrierung wird der Rückruf mit dem aktuellen Wert der Energieeinstellung aufgerufen. Wenn die Registrierung erfolgt, während sich die Energieeinstellung ändert, erhalten Sie möglicherweise mehrere Rückrufe. der letzte Rückruf ist das neueste Update.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	powersetting.h
Bibliothek	Powrprof.lib
DLL	Powrprof.dll

Weitere Informationen

GUIDs für Energieeinstellungen

PowerSettingUnregisterNotification

Freigeben über