Функция RegisterPowerSettingNotification (winuser.h)

Статья
08/27/2023

Регистрирует приложение для получения уведомлений о параметрах питания для конкретного события параметров питания.

Синтаксис

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

Параметры

[in] hRecipient

Дескриптор, указывающий, куда должны отправляться уведомления о параметрах питания. Для интерактивных приложений параметр Flags должен быть равен нулю, а параметр hRecipient — дескриптором окна. Для служб параметр Flags должен быть одним, а параметр hRecipient должен быть SERVICE_STATUS_HANDLE , возвращенный из RegisterServiceCtrlHandlerEx.

[in] PowerSettingGuid

GUID параметра питания, для которого отправляются уведомления. Дополнительные сведения см. в разделе Регистрация для power Events.

[in] Flags

Значение	Значение
DEVICE_NOTIFY_WINDOW_HANDLE 0	Уведомления отправляются с помощью WM_POWERBROADCAST сообщений с параметром wParamPBT_POWERSETTINGCHANGE.
DEVICE_NOTIFY_SERVICE_HANDLE 1	Уведомления отправляются в функцию обратного вызова HandlerEx с параметром dwControlSERVICE_CONTROL_POWEREVENT и dwEventTypePBT_POWERSETTINGCHANGE.

Возвращаемое значение

Возвращает дескриптор уведомления для отмены регистрации уведомлений о энергопотреблении. Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-powermanagement-l1-1-0 (представлено в Windows 8)

См. также раздел

Функции управления питанием

Регистрация для событий Power

Отмена регистрацииPowerSettingNotification

Share via