PowerClearRequest 함수(winbase.h)

전원 요청 개체에 대해 지정된 형식의 전원 요청 수를 감소합니다.

구문

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

[in] PowerRequest

전원 요청 개체에 대한 핸들입니다.

[in] RequestType

감소할 전원 요청 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
PowerRequestDisplayRequired	장시간 사용자 입력이 없더라도 디스플레이는 계속 켜져 있습니다.
PowerRequestSystemRequired	시스템이 사용자 비활성 기간 후에 절전 모드로 들어가는 대신 계속 실행됩니다.
PowerRequestAwayModeRequired	시스템이 절전 모드가 아닌 멀리 모드로 전환됩니다. 어웨이 모드에서는 시스템이 계속 실행되지만 절전 모드의 모양을 제공하기 위해 오디오 및 비디오를 끕니다.
PowerRequestExecutionRequired	호출 프로세스는 프로세스 수명 관리 메커니즘에 의해 일시 중단되거나 종료되는 대신 계속 실행됩니다. 프로세스를 실행할 수 있는 시기와 기간은 운영 체제 및 전원 정책 설정에 따라 달라집니다. PowerRequestExecutionRequired 요청이 활성 상태이면 PowerRequestSystemRequired를 의미합니다. PowerRequestExecutionRequired 요청 형식은 애플리케이션에서만 사용할 수 있습니다. 서비스에서 이 요청 유형을 사용할 수 없습니다. Windows 7 및 Windows Server 2008 R2: 이 요청 유형은 Windows 8 및 Windows Server 2012 시작해서 지원됩니다.

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

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