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 메서드는 다음 값 중 하나를 반환합니다.

설명

IScheduledWorkItem 인터페이스의 메서드는 ITask 인터페이스에서 상속됩니다. 따라서 IScheduledWorkItem::GetStatus 는 일반적으로 ITask 인터페이스를 통해 호출됩니다.

IScheduledWorkItem::GetStatus는 작업의 상태 동적으로 가져오지 않습니다. 업데이트된 상태 가져오는 데 사용되는 새 IScheduledWorkItem 인터페이스를 가져오려면 ITaskScheduler::Activate를 호출해야 합니다. 자세한 내용은 ITaskScheduler::Activate에 대한 예제를 참조하세요.

예제

작업의 상태 검색하는 방법에 대한 예제는 C/C++ 코드 예제: 작업 상태 검색을 참조하세요.

작업 종료의 일부로 작업 상태 검색하는 방법에 대한 예제는 작업 예제 종료를 참조하세요.

요구 사항

추가 정보

IScheduledWorkItem

Itask