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，并且未为 user 参数指定值，则任务计划程序服务将尝试以交互方式启动任务，作为登录到指定会话的用户。

如果TASK_RUN_USE_SESSION_ID常量传递到 flags 参数中，并且 sessionID 值是大于 0 的有效会话 ID，并且用户在 user 参数中指定了用户，则任务计划程序服务将尝试以交互方式启动任务，作为 在 user 参数中指定的用户。

runningTask [out]

一个定义任务的新实例的 RunningTask 对象。

此方法不返回值。

此方法将返回而不会出错，但如果已注册任务的 TaskSettings.AllowDemandStart 属性设置为 false，则任务将不会运行。