Funzione RegisterPowerSettingNotification (winuser.h)
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 |
|---|---|
|
Le notifiche vengono inviate usando WM_POWERBROADCAST messaggi con un parametro wParam di PBT_POWERSETTINGCHANGE. |
|
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) |