ReadPwrScheme 함수(powrprof.h)

[ReadPwrScheme 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 설명을 참조하세요.]

지정된 전원 구성표에 고유한 전원 정책 설정을 검색합니다.

구문

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

[in] uiID

읽을 전원 구성표의 인덱스입니다.

[out] pPowerPolicy

전원 정책 설정을 수신하는 POWER_POLICY 구조체에 대한 포인터입니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

지정된 전원 구성표가 없으면 함수는 FALSE를 반환합니다.

시스템에서 현재 사용 중인 전원 정책 설정에 대한 정보를 검색하려면 GetActivePwrScheme 함수를 호출합니다. 현재 전원 정책 설정에 대한 추가 정보를 검색하려면 CallNtPowerInformation 함수를 호출합니다.

Windows Vista부터 PowerEnumerate 함수를 사용하여 지정된 스키마에 대한 전원 설정을 열거하고 전원 읽기 함수를 사용하여 개별 설정을 검색합니다.

PowrProf.h 사용에 대한 자세한 내용은 전원 구성표를 참조하세요.