Fonction RegisterPowerSettingNotification (winuser.h)

Article
08/27/2023

Inscrit l’application pour recevoir des notifications de paramètre d’alimentation pour l’événement de paramètre d’alimentation spécifique.

Syntaxe

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

Paramètres

[in] hRecipient

Handle indiquant où les notifications de paramètre d’alimentation doivent être envoyées. Pour les applications interactives , le paramètre Flags doit être égal à zéro et le paramètre hRecipient doit être un handle de fenêtre. Pour les services, le paramètre Flags doit en être un et le paramètre hRecipient doit être un SERVICE_STATUS_HANDLE comme retourné par RegisterServiceCtrlHandlerEx.

[in] PowerSettingGuid

GUID du paramètre d’alimentation pour lequel les notifications doivent être envoyées. Pour plus d’informations, consultez Inscription aux événements Power.

[in] Flags

Valeur	Signification
DEVICE_NOTIFY_WINDOW_HANDLE 0	Les notifications sont envoyées à l’aide de messages WM_POWERBROADCAST avec un paramètre wParamde PBT_POWERSETTINGCHANGE.
DEVICE_NOTIFY_SERVICE_HANDLE 1	Les notifications sont envoyées à la fonction de rappel HandlerEx avec un paramètre dwControlde SERVICE_CONTROL_POWEREVENT et un dwEventType de PBT_POWERSETTINGCHANGE.

Valeur retournée

Retourne un handle de notification pour la désinscription des notifications d’alimentation. Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-powermanagement-l1-1-0 (introduit dans Windows 8)

Voir aussi

Fonctions de gestion de l’alimentation

Inscription aux événements Power

DésinscrirePowerSettingNotification

Partager via