다음을 통해 공유

RegisteredTask.RunEx 메서드

  • 아티클

스크립팅의 경우 지정된 플래그 및 세션 식별자를 사용하여 등록된 작업을 즉시 실행합니다.

구문

RegisteredTask.RunEx( _
  ByVal params, _
  ByVal flags, _
  ByVal sessionID, _
  ByRef runningTask _
)

매개 변수

params [in]

작업 작업에서 값으로 사용되는 매개 변수입니다. 작업 작업에 대한 매개 변수 값을 지정하지 않하려면 이 매개 변수를 Nothing으로 설정합니다. 그렇지 않으면 단일 문자열 값 또는 문자열 값 배열을 지정할 수 있습니다.

지정한 문자열 값은 이름과 쌍을 이고 이름-값 쌍으로 저장됩니다. 단일 문자열 값을 지정하면 Arg0이 값에 할당된 이름이 됩니다. 값은 작업 속성에서 $(Arg0) 변수가 사용되는 작업 작업에서 사용할 수 있습니다.

"0", "100" 및 "250"과 같은 값을 문자열 값 배열로 전달하면 "0"이 $(Arg0) 변수를 대체하고 "100"은 $(Arg1) 변수를 대체하고 "250"은 작업 속성에 사용되는 $(Arg2) 변수를 대체합니다.

최대 32개 문자열 값을 지정할 수 있습니다.

값에 $(Arg0), $(Arg1), ..., $(Arg32) 변수를 사용할 수 있는 작업 속성의 자세한 내용과 목록은 작업 작업을 참조하세요.

flags [in]

태스크 실행 방법을 정의하는 TASK_RUN_FLAGS 상수입니다.

sessionID [in]

작업을 시작할 터미널 서버 세션입니다.

TASK_RUN_USE_SESSION_ID 상수(0x4)가 flags 매개 변수에 전달되지 않으면 이 매개 변수에 지정된 값이 무시됩니다. TASK_RUN_USE_SESSION_ID 상수가 flags 매개 변수에 전달되고 sessionID 값이 0보다 작거나 같으면 잘못된 인수 오류가 반환됩니다.

TASK_RUN_USE_SESSION_ID 상수가 flags 매개 변수에 전달되고 sessionID 값이 0보다 큰 유효한 세션 ID이고 사용자 매개 변수에 대해 값이 지정되지 않은 경우 작업 스케줄러 서비스는 지정된 세션에 로그온한 사용자로서 대화형으로 작업을 시작하려고 시도합니다.

TASK_RUN_USE_SESSION_ID 상수가 flags 매개 변수에 전달되고 sessionID 값이 0보다 큰 유효한 세션 ID이고 사용자가 사용자 매개 변수에 지정된 경우 작업 스케줄러 서비스는 사용자 매개 변수에 지정된 사용자로 대화형으로 작업을 시작하려고 시도합니다.

runningTask [out]

작업의 새 instance 정의하는 RunningTask 개체입니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

이 메서드는 오류 없이 반환되지만 TaskSettings.AllowDemandStart 속성이 등록된 작업에 대해 false로 설정된 경우 작업이 실행되지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
유형 라이브러리
Taskschd.tlb
DLL
Taskschd.dll

추가 정보

작업 Scheduler

RegisteredTask