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 사용에 대한 자세한 내용은 전원 구성표를 참조하세요. 시스템을 절전 모드 해제할 수 있는 이벤트에 대한 자세한 내용은 시스템 절전 모드 해제 이벤트를 참조하세요.