IRegisteredTask::RunEx 메서드(taskschd.h)

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

통사론

HRESULT RunEx(
  [in]            VARIANT      params,
  [in]            LONG         flags,
  [in]            LONG         sessionID,
  [in]            BSTR         user,
  [out, optional] IRunningTask **ppRunningTask
);

매개 변수

[in] params

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

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

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

최대 32BSTR 값을 지정할 수 있습니다.

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

[in] flags

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

[in] sessionID

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

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

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

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

[in] user

태스크가 실행되는 사용자입니다.

[out, optional] ppRunningTask

작업의 새 인스턴스를 정의하는 IRunningTask 인터페이스입니다.

NULLIRunningTask 인터페이스 포인터에 대한 참조를 전달합니다. NULL 포인터를 참조하면 포인터를 덮어쓰기 때문에 메모리 누수가 발생할 수 있습니다.

반환 값

이 메서드가 성공하면 S_OK반환됩니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

발언

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

IRegisteredTask::RunEx 사용하지 않도록 설정된 작업에서 호출되면 S_OK 반환되지만 태스크는 실행되지 않습니다.

요구 사항

참고 항목

IRegisteredTask

작업 스케줄러