다음을 통해 공유


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

등록된 작업을 즉시 실행합니다.

통사론

HRESULT Run(
  [in]            VARIANT      params,
  [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) 변수를 사용할 수 있는 작업 속성 목록 및 자세한 내용은 작업 작업참조하세요.

[out, optional] ppRunningTask

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

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

반환 값

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

발언

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

IRegisteredTask::Run 함수는 플래그 매개 변수가 0이고 사용자 매개 변수가 NULL같은 IRegisteredTask::RunEx 함수와 동일합니다.

IRegisteredTask::Run 비활성화된 작업에서 호출되면 SCHED_E_TASK_DISABLED 반환됩니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 taskschd.h
라이브러리 Taskschd.lib
DLL Taskschd.dll

참고 항목

IRegisteredTask

작업 스케줄러