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

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

마지막 실행에서 작업 항목 과 연결된 실행 파일에서 반환된 마지막 종료 코드를 검색합니다. 또한 메서드는 작업 항목을 마지막으로 실행하려고 할 때 작업 스케줄러에 반환된 종료 코드를 반환합니다.

구문

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

매개 변수

[out] pdwExitCode

작업 항목의 마지막 종료 코드로 설정된 DWORD 값에 대한 포인터입니다. 마지막으로 실행이 중지되었을 때 작업 항목이 반환한 종료 코드입니다. 작업 항목이 시작되지 않은 경우 0이 반환됩니다.

반환 값

GetExitCode 메서드는 작업 항목을 시작하려는 마지막 시도에서 오류를 반환합니다. 가능한 값은 다음과 같습니다.

반환 코드 Description
S_OK
작업 항목을 시작하려고 시도했습니다.
SCHED_S_TASK_HAS_NOT_RUN
이 작업 항목을 시작하려고 시도한 적이 없습니다.
E_INVALIDARG
인수가 잘못되었습니다.
E_OUTOFMEMORY
사용 가능한 메모리가 부족합니다.

설명

이 메서드는 다음 두 가지 정보를 반환할 수 있습니다.

  • 예약 중인 실행 파일에서 반환되는 오류 또는 종료 코드는 pdwExitCode 매개 변수에 반환됩니다.
  • 작업을 시작하려고 할 때 작업 스케줄러가 받은 오류 코드는 GetExitCode 메서드 호출 자체에서 반환됩니다.
업데이트된 오류 코드를 가져오려면 항상 먼저 ITaskScheduler::Activate 를 호출하여 새 IScheduledWorkItem 인터페이스를 가져온 다음 업데이트된 오류 코드를 가져오는 데 사용할 수 있습니다.

예제

작업 작성자를 검색하는 방법에 대한 예제는 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 이상

추가 정보

IScheduledWorkItem