Функция SetActivePwrScheme (powrprof.h)

Статья
08/25/2023

[Метод 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