SetSystemPowerState 함수(winbase.h)

아티클
08/27/2023

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

전원을 종료하여 시스템을 일시 중단합니다. ForceFlag 매개 변수에 따라 함수는 작업을 즉시 일시 중단하거나 작업을 수행하기 전에 모든 애플리케이션 및 디바이스 드라이버에서 권한을 요청합니다.

구문

BOOL SetSystemPowerState(
  [in] BOOL fSuspend,
  [in] BOOL fForce
);

매개 변수

[in] fSuspend

이 매개 변수가 TRUE이면 시스템이 일시 중단됩니다. 매개 변수가 FALSE이면 시스템이 최대 절전 모드로 전환됩니다.

[in] fForce

이 매개 변수는 아무런 영향을 주지 않습니다.

반환 값

전원이 일시 중단되고 이후에 복원된 경우 반환 값은 0이 아닌 값입니다.

시스템이 일시 중단되지 않은 경우 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

호출 프로세스에는 SE_SHUTDOWN_NAME 권한이 있어야 합니다. SE_SHUTDOWN_NAME 권한을 사용하도록 설정하려면 AdjustTokenPrivileges 함수를 사용합니다. 자세한 내용은 토큰의 권한 변경을 참조하세요.

애플리케이션 또는 드라이버가 작업 일시 중단 권한을 거부하는 경우 함수는 각 애플리케이션 및 드라이버에 PBT_APMQUERYSUSPENDFAILED 이벤트를 브로드캐스트합니다. 전원이 일시 중단된 경우 이 함수는 시스템 작업이 재개되고 관련 WM_POWERBROADCAST 메시지가 모든 애플리케이션 및 드라이버에 브로드캐스트된 후에만 반환됩니다.

이 함수는 SetSuspendState 함수와 비슷합니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 매크로를 0x0400 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll