ITask::SetMaxRunTime 메서드(mstask.h)

  • 아티클

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

이 메서드는 종료하기 전에 태스크 를 실행할 수 있는 최대 시간(밀리초)을 설정합니다.

구문

HRESULT SetMaxRunTime(
  [in] DWORD dwMaxRunTimeMS
);

매개 변수

[in] dwMaxRunTimeMS

작업에 대한 최대 런타임(밀리초)을 지정하는 DWORD 값입니다. 이 매개 변수는 무제한 시간을 지정하기 위해 INFINITE로 설정할 수 있습니다.

반환 값

SetMaxRunTime 메서드는 다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
 작업이 완료되었습니다.
E_INVALIDARG
 인수가 잘못되었습니다.
E_OUTOFMEMORY
 사용 가능한 메모리가 부족합니다.

설명

최대 런타임을 초과하면 작업 스케줄러는 작업과 연결된 애플리케이션을 종료하려고 시도합니다. WM_CLOSE 메시지를 보낼 수 없거나(예: 애플리케이션에 창이 없음) 수신 WM_CLOSE 3분 이내에 애플리케이션이 종료되지 않은 경우 작업 스케줄러는 TerminateProcess를 사용하여 애플리케이션을 종료합니다.

최대 런타임을 설정한 후 IPersistFile::Save 를 호출하여 수정된 작업 개체를 디스크에 저장해야 합니다.

예제

최대 런타임을 설정하는 방법에 대한 예제는 C/C++ 코드 예제: MaxRunTime 설정을 참조하세요.

요구 사항

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

추가 정보

IGetMaxRunTime

Itask