Функция 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
Значение | Значение |
---|---|
|
Уведомления отправляются с помощью WM_POWERBROADCAST сообщений с параметром wParamPBT_POWERSETTINGCHANGE. |
|
Уведомления отправляются в функцию обратного вызова 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) |