Функция SetActivePwrScheme (powrprof.h)
[Метод SetActivePwrScheme доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Приложения, написанные для Windows Vista и более поздних версий, должны использовать PowerSetActiveScheme .]
Задает активную схему питания.
Синтаксис
BOOLEAN SetActivePwrScheme(
[in] UINT uiID,
[in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
[in, optional] PPOWER_POLICY pPowerPolicy
);
Параметры
[in] uiID
Индекс схемы питания для активации.
[in, optional] pGlobalPowerPolicy
Указатель на необязательную структуру GLOBAL_POWER_POLICY , которая предоставляет параметры глобальной политики управления питанием для объединения со схемой управления питанием при ее активации.
[in, optional] pPowerPolicy
Указатель на необязательную структуру POWER_POLICY , которая предоставляет параметры политики управления питанием для объединения со схемой управления питанием, когда она становится активной.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Используйте эту функцию для внесения долгосрочных изменений в конфигурацию системы. Чтобы временно сохранить систему во время выполнения задачи приложением, используйте функцию SetThreadExecutionState .
Если схема питания, указанная uiID , не существует, функция возвращает ноль.
Если lpGlobalPowerPolicy имеет значение NULL, функция использует текущие параметры глобальной политики питания, заданные WriteGlobalPwrPolicy. В противном случае параметры в указанной структуре заменяют текущие параметры глобальной политики управления питанием.
Если lpPowerPolicy имеет значение NULL, функция использует текущие параметры политики питания для схемы управления питанием. В противном случае параметры в указанной структуре заменяют текущие параметры политики управления питанием.
Дополнительные сведения об использовании PowrProf.h см. в разделе Схемы питания.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | powrprof.h |
| Библиотека | PowrProf.lib |
| DLL | PowrProf.dll |