SetActivePwrScheme 함수(powrprof.h)

아티클
08/25/2023

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

활성 전원 구성표를 설정합니다.

구문

BOOLEAN SetActivePwrScheme(
  [in]           UINT                 uiID,
  [in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [in, optional] PPOWER_POLICY        pPowerPolicy
);

매개 변수

[in] uiID

활성화할 전원 구성표의 인덱스입니다.

[in, optional] pGlobalPowerPolicy

활성화될 때 전원 구성표와 병합할 전역 전원 정책 설정을 제공하는 선택적 GLOBAL_POWER_POLICY 구조체에 대한 포인터입니다.

[in, optional] pPowerPolicy

전원이 활성화될 때 전원 구성표와 병합할 전원 정책 설정을 제공하는 선택적 POWER_POLICY 구조체에 대한 포인터입니다.

반환 값

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

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

설명

이 함수를 사용하여 시스템 구성을 장기적으로 변경합니다. 애플리케이션이 작업을 수행하는 동안 시스템을 일시적으로 실행하려면 SetThreadExecutionState 함수를 사용합니다.

uiID로 지정된 전원 구성표가 없으면 함수는 0을 반환합니다.

lpGlobalPowerPolicy가 NULL인 경우 함수는 WriteGlobalPwrPolicy에서 설정한 현재 전역 전원 정책 설정을 사용합니다. 그렇지 않으면 지정된 구조의 설정이 현재 전역 전원 정책 설정을 대체합니다.

lpPowerPolicy가 NULL인 경우 함수는 전원 구성표에 대한 현재 전원 정책 설정을 사용합니다. 그렇지 않으면 지정된 구조의 설정이 현재 전원 정책 설정을 대체합니다.

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

요구 사항

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