Метод 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 и если для параметра пользователя не указано значение, служба планировщика задач попытается запустить задачу в интерактивном режиме от имени пользователя, выполнившего вход в указанный сеанс.

Если константы TASK_RUN_USE_SESSION_ID передаются в параметр flags , а значение sessionID является допустимым идентификатором сеанса больше 0 и если пользователь указан в параметре user , служба планировщика задач попытается запустить задачу в интерактивном режиме от имени пользователя, указанного в параметре пользователя .

runningTask [out]

Объект RunningTask , определяющий новый экземпляр задачи.

Возвращаемое значение

Этот метод не возвращает значение.

Комментарии

Этот метод возвращается без ошибок, но задача не будет выполняться, если свойству TaskSettings.AllowDemandStart присвоено значение false для зарегистрированной задачи.

Требования

См. также раздел

Планировщик заданий

RegisteredTask