Поделиться через

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

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

Синтаксис

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

  • Last updated on