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

Статья
08/25/2023

[WritePwrScheme больше недоступен для использования в Windows Vista. Вместо этого используйте функцию PowerEnumerate для перечисления параметров питания для указанной схемы и функции записи питания для записи отдельных параметров.]

Записывает параметры политики, уникальные для указанной схемы управления питанием.

Синтаксис

BOOLEAN WritePwrScheme(
  [in]           PUINT         puiID,
  [in]           LPCWSTR       lpszSchemeName,
  [in, optional] LPCWSTR       lpszDescription,
  [in]           PPOWER_POLICY lpScheme
);

Параметры

[in] puiID

Индекс схемы питания для записи. Если схема питания с тем же индексом уже существует, она заменяется. В противном случае создается новая схема питания.

[in] lpszSchemeName

Имя схемы питания.

[in, optional] lpszDescription

Описание схемы питания.

[in] lpScheme

Указатель на структуру POWER_POLICY , содержащую параметры политики управления питанием, которые необходимо записать.

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

Если функция выполняется успешно, возвращается ненулевое значение.

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

Это изменение не влияет на текущую политику управления питанием системы. Чтобы применить это изменение к текущей системной политике управления питанием, вызовите функцию SetActivePwrScheme с индексом этой схемы управления питанием.

Схемы политики питания, написанные с помощью WritePwrScheme , постоянно хранятся в кустах системного реестра и остаются доступными для использования в программе панели управления Параметры питания или при последующих вызовах API схемы питания. Чтобы окончательно удалить схему питания из системы, вызовите функцию DeletePwrScheme .

Дополнительные сведения об использовании PowrProf.h см. в разделе Схемы питания.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	powrprof.h
Библиотека	PowrProf.lib
DLL	PowrProf.dll