EnumPwrSchemes 함수(powrprof.h)

[EnumPwrSchemes 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. Windows Vista 이상용으로 작성된 애플리케이션은 PowerEnumerate 를 대신 사용해야 합니다.]

모든 전원 구성표를 열거합니다. 열거된 각 전원 구성표에 대해 함수는 전원 구성표에 대한 정보를 사용하여 콜백 함수를 호출합니다.

구문

BOOLEAN EnumPwrSchemes(
  [in] PWRSCHEMESENUMPROC lpfn,
  [in] LPARAM             lParam
);

매개 변수

[in] lpfn

열거된 각 전원 구성표에 대해 호출할 콜백 함수에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하세요.

[in] lParam

콜백 함수에 전달할 사용자 정의 값입니다.

반환 값

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

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

설명

열거된 각 전원 구성표에 대해 콜백 함수는 다음 매개 변수를 사용하여 호출됩니다.

typedef BOOLEAN (CALLBACK* PWRSCHEMESENUMPROC)(
  UINT uiIndex,      // power scheme index
  DWORD dwName,      // size of the sName string, in bytes
  LPWSTR sName,      // name of the power scheme
  DWORD dwDesc,      // size of the sDesc string, in bytes
  LPWSTR sDesc,      // description string
  PPOWER_POLICY pp,  // receives the power policy
  LPARAM lParam      // user-defined value
);

sName 및 sDesc 매개 변수는 null로 끝나는 유니코드 문자열입니다. pp 매개 변수는 전원 정책 구성표를 포함하는 POWER_POLICY 구조체에 대한 포인터입니다. 모든 전원 구성표가 열거될 때까지 계속하려면 콜백 함수가 TRUE를 반환해야 합니다. 열거형을 중지하려면 콜백 함수가 FALSE를 반환해야 합니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	powrprof.h
라이브러리	PowrProf.lib
DLL	PowrProf.dll

추가 정보

POWER_POLICY

전원 관리 함수

전원 구성표