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

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

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

Синтаксис

BOOLEAN ReadPwrScheme(
  [in]  UINT          uiID,
  [out] PPOWER_POLICY pPowerPolicy
);

Параметры

[in] uiID

Индекс схемы питания для чтения.

[out] pPowerPolicy

Указатель на структуру POWER_POLICY , которая получает параметры политики управления питанием.

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

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

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

Комментарии

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

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

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

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

Требования

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

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

GetActivePwrScheme

POWER_POLICY

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

Схемы питания

WritePwrScheme