Функция WritePwrScheme (powrprof.h)
[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 |