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

Статья
08/25/2023

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

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

Синтаксис

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

Параметры

[in] uiID

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

[out] pPowerPolicy

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

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

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

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

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

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

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

Требования

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