Funzione RegisterPowerSettingNotification (winuser.h)

Articolo
08/27/2023

Registra l'applicazione per ricevere notifiche relative all'impostazione di alimentazione per l'evento specifico dell'impostazione di alimentazione.

Sintassi

HPOWERNOTIFY RegisterPowerSettingNotification(
  [in] HANDLE  hRecipient,
  [in] LPCGUID PowerSettingGuid,
  [in] DWORD   Flags
);

Parametri

[in] hRecipient

Handle che indica dove inviare le notifiche relative all'impostazione di alimentazione. Per le applicazioni interattive, il parametro Flags deve essere zero e il parametro hRecipient deve essere un handle di finestra. Per i servizi, il parametro Flags deve essere uno e il parametro hRecipient deve essere un SERVICE_STATUS_HANDLE restituito da RegisterServiceCtrlHandlerEx.

[in] PowerSettingGuid

GUID dell'impostazione di alimentazione per cui inviare le notifiche. Per altre informazioni, vedere Registrazione per gli eventi di Power.

[in] Flags

Valore	Significato
DEVICE_NOTIFY_WINDOW_HANDLE 0	Le notifiche vengono inviate usando WM_POWERBROADCAST messaggi con un parametro wParam di PBT_POWERSETTINGCHANGE.
DEVICE_NOTIFY_SERVICE_HANDLE 1	Le notifiche vengono inviate alla funzione di callback HandlerEx con un parametro dwControl di SERVICE_CONTROL_POWEREVENT e un dwEventType di PBT_POWERSETTINGCHANGE.

Valore restituito

Restituisce un handle di notifica per la registrazione delle notifiche di alimentazione. Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-powermanagement-l1-1-0 (introdotto in Windows 8)

Vedi anche

Funzioni di risparmio energia

Registrazione per gli eventi di Power

UnregisterPowerSettingNotification

Condividi tramite