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 |