Condividi tramite

Funzione RegisterPowerSettingNotification (winuser.h)

  • Articolo

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