IScheduledWorkItem::GetStatus 메서드(mstask.h)
[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없을 수 있습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]
작업 항목의 상태 검색합니다.
구문
HRESULT GetStatus(
[out] HRESULT *phrStatus
);
매개 변수
[out] phrStatus
반환 시 다음 값 중 하나를 포함하는 HRESULT 값에 대한 포인터입니다.
SCHED_S_TASK_READY
작업 항목은 다음 예약된 시간에 실행할 준비가 된 것입니다.
SCHED_S_TASK_RUNNING
작업 항목이 현재 실행 중입니다.
SCHED_S_TASK_NOT_SCHEDULED
일정에 따라 이 작업을 실행하는 데 필요한 속성 중 하나 이상이 설정되지 않았습니다.
SCHED_S_TASK_HAS_NOT_RUN
작업이 실행되지 않았습니다. 이 값은 작업이 다음 예약된 시간에 실행될 준비가 되었거나 작업이 되풀이 작업인 경우에도 작업이 실행되지 않을 때마다 반환됩니다.
SCHED_S_TASK_DISABLED
작업이 사용하지 않도록 설정되었으므로 예약된 시간에 실행되지 않습니다.
SCHED_S_TASK_NO_MORE_RUNS
이 작업에 대해 예약된 실행이 더 이상 없습니다.
SCHED_S_TASK_NO_VALID_TRIGGERS
작업에 트리거가 없거나 기존 트리거가 비활성화되었거나 설정되지 않았습니다.
반환 값
GetStatus 메서드는 다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
작업이 완료되었습니다. 요청이 전송되었습니다. 자세한 내용은 설명 부분을 참조하세요. |
|
인수가 잘못되었습니다. |
설명
IScheduledWorkItem 인터페이스의 메서드는 ITask 인터페이스에서 상속됩니다. 따라서 IScheduledWorkItem::GetStatus 는 일반적으로 ITask 인터페이스를 통해 호출됩니다.
IScheduledWorkItem::GetStatus는 작업의 상태 동적으로 가져오지 않습니다. 업데이트된 상태 가져오는 데 사용되는 새 IScheduledWorkItem 인터페이스를 가져오려면 ITaskScheduler::Activate를 호출해야 합니다. 자세한 내용은 ITaskScheduler::Activate에 대한 예제를 참조하세요.
예제
작업의 상태 검색하는 방법에 대한 예제는 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 이상 |