IScheduledWorkItem::GetIdleWait 메서드(mstask.h)
[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]
작업 항목의 유휴 대기 시간을 검색합니다.
유휴 상태에 대한 자세한 내용은 작업 유휴 조건을 참조하세요.
구문
HRESULT GetIdleWait(
[out] WORD *pwIdleMinutes,
[out] WORD *pwDeadlineMinutes
);
매개 변수
[out] pwIdleMinutes
현재 작업 항목의 유휴 대기 시간(분)이 포함된 WORD 에 대한 포인터입니다.
[out] pwDeadlineMinutes
작업 스케줄러가 pwIdleMinutes에서 반환된 유휴 기간 동안 대기할 최대 시간(분)을 지정하는 WORD에 대한 포인터입니다.
반환 값
GetIdleWait 메서드는 다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
인수가 잘못되었습니다. |
설명
여기서 반환되는 유휴 시간은 유휴 트리거 및 유휴 조건과 함께 사용됩니다. 유휴 트리거는 예약된 시간과 연결되지 않은 이벤트 기반 트리거입니다. 유휴 상태는 작업의 예약된 시작 시간과 연결됩니다.
유휴 트리거는 TASK_TRIGGER 구조체의 TASK_TRIGGER_TYPE 멤버를 TASK_EVENT_TRIGGER_ON_IDLE 값으로 설정하여 지정합니다. 시스템이 pwIdleMinutes에서 반환된 시간 동안 유휴 상태가 되면 유휴 트리거가 발생합니다.
IScheduledWorkItem::SetFlags를 호출하여 유휴 조건을 설정할 수 있습니다. TASK_FLAG_START_ONLY_IF_IDLE 플래그가 설정된 경우 시스템이 pwIdleMinutes에서 반환된 시간 동안 유휴 상태가 되는 경우에만 작업 항목이 예약된 시간에 실행됩니다. 작업 스케줄러 서비스는 예약된 시작 시간을 지나 pwDeadlineMinutes 까지 대기하여 시스템이 유휴 상태가 되는지 확인합니다.
예제
작업의 유휴 대기 시간을 검색하는 방법에 대한 예제는 C/C++ 코드 예제: 작업 유휴 대기 시간 검색을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mstask.h |
| 라이브러리 | Mstask.lib |
| DLL | Mstask.dll |
| 재배포 가능 파일 | Windows NT 4.0 및 Windows 95에서 인터넷 Explorer 4.0 이상 |