PowerSettingRegisterNotification-Funktion (powersetting.h)
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 |
|---|---|
|
Der Recipient-Parameter ist ein Handle für einen Dienst. Verwenden Sie die CreateService - oder OpenService-Funktion , um dieses Handle abzurufen. |
|
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 |