다음을 통해 공유


SetSuspendState 함수(powrprof.h)

전원을 종료하여 시스템을 일시 중단합니다. Hibernate 매개 변수에 따라 시스템은 일시 중단(절전 모드) 상태 또는 최대 절전 모드(S4)를 입력합니다.

구문

BOOLEAN SetSuspendState(
  [in] BOOLEAN bHibernate,
  [in] BOOLEAN bForce,
  [in] BOOLEAN bWakeupEventsDisabled
);

매개 변수

[in] bHibernate

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

[in] bForce

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

[in] bWakeupEventsDisabled

이 매개 변수가 TRUE이면 시스템에서 모든 절전 모드 해제 이벤트를 사용하지 않도록 설정합니다. 매개 변수가 FALSE이면 시스템 절전 모드 해제 이벤트가 계속 활성화됩니다.

반환 값

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

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

설명

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

애플리케이션은 SetSuspendState 를 사용하여 시스템을 작업 상태에서 대기(절전 모드) 또는 필요에 따라 최대 절전 모드(S4) 상태로 전환할 수 있습니다. 이 함수는 SetSystemPowerState 함수와 유사합니다 .

PowrProf.h 사용에 대한 자세한 내용은 전원 구성표를 참조하세요. 시스템을 절전 모드 해제할 수 있는 이벤트에 대한 자세한 내용은 시스템 절전 모드 해제 이벤트를 참조하세요.

요구 사항

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

추가 정보

PBT_APMQUERYSUSPEND

PBT_APMSUSPEND

전원 관리 함수