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

[WriteGlobalPwrPolicy доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. См. примечания.]

Записывает параметры глобальной политики управления питанием.

Синтаксис

BOOLEAN WriteGlobalPwrPolicy(
  [in] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

Параметры

[in] pGlobalPowerPolicy

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

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

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

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

Комментарии

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

Начиная с Windows Vista, используйте функцию PowerEnumerate для перечисления параметров питания для указанной схемы и функции записи питания для записи отдельных параметров.

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

Требования

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

См. также раздел

GLOBAL_POWER_POLICY

Функции управления питанием

ReadGlobalPwrPolicy