다음을 통해 공유


IScheduledWorkItem::SetIdleWait 메서드(mstask.h)

[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]

작업 항목을 실행하기 전에 시스템이 유휴 상태여야 하는 시간(분)을 설정합니다.

구문

HRESULT SetIdleWait(
  [in] WORD wIdleMinutes,
  [in] WORD wDeadlineMinutes
);

매개 변수

[in] wIdleMinutes

작업 항목을 실행하기 전에 시스템이 유휴 상태로 유지되어야 하는 시간(분)을 지정하는 값입니다.

[in] wDeadlineMinutes

작업 스케줄러가 pwIdleMinutes에서 반환된 유휴 기간 동안 대기할 최대 시간(분)을 지정하는 값입니다.

반환 값

SetIdleWait 메서드는 S_OK 반환합니다.

설명

여기에 지정된 유휴 시간은 유휴 트리거유휴 조건과 함께 사용됩니다. 자세한 내용은 작업 유휴 조건을 참조하세요. 유휴 트리거는 예약된 시간과 연결되지 않은 이벤트 기반 트리거입니다. 반면 유휴 조건은 작업의 예약된 시작 시간과 연결됩니다.

TASK_TRIGGER TASK_TRIGGER_TYPE 멤버를 TASK_EVENT_TRIGGER_ON_IDLE 설정하여 유휴 트리거를 지정합니다. 시스템이 wIdleMinutes에 지정된 시간 동안 유휴 상태가 되면 유휴 트리거가 발생합니다.

IScheduledWorkItem::SetFlags를 호출하여 유휴 조건을 설정합니다. TASK_FLAG_START_ONLY_IF_IDLE 플래그가 설정된 경우 wIdleMinutes에서 지정한 시간 동안 시스템이 유휴 상태가 되는 경우에만 작업 항목이 예약된 시간에 실행됩니다. 작업 스케줄러 서비스는 예약된 시작 시간을 초과하여 wDeadlineMinutes 에 지정된 시간(분)까지 대기하여 시스템이 유휴 상태가 되는지 확인합니다.

애플리케이션은 SetIdleWait을 호출한 후 IPersistFile::Save 메서드를 호출하여 유휴 대기 간격을 업데이트해야 합니다.

예제

유휴 트리거를 만들 때 유휴 대기 시간을 설정하는 방법에 대한 예제는 유휴 트리거 만들기 예제를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mstask.h
라이브러리 Mstask.lib
DLL Mstask.dll
재배포 가능 파일 Windows NT 4.0 및 Windows 95에서 인터넷 Explorer 4.0 이상

추가 정보

IScheduledWorkItem

IScheduledWorkItem::GetIdleWait