Método RegisteredTask.RunEx

Para el scripting, ejecuta la tarea registrada inmediatamente con marcas especificadas y un identificador de sesión.

Sintaxis

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

Parámetros

parámetros [in]

Parámetros usados como valores en las acciones de tarea. Para no especificar ningún valor de parámetro para las acciones de tarea, establezca este parámetro en Nothing. De lo contrario, se puede especificar un valor de cadena único o una matriz de valores de cadena.

Los valores de cadena que especifique se emparejan con nombres y se almacenan como pares nombre-valor. Si especifica un valor de cadena único, Arg0 será el nombre asignado al valor. El valor se puede usar en la acción de tarea donde se usa la variable $(Arg0) en las propiedades de la acción.

Si pasa valores como "0", "100" y "250" como una matriz de valores de cadena, "0" reemplazará las variables $(Arg0), "100" reemplazará las variables $(Arg1) y "250" reemplazará las variables $(Arg2) usadas en las propiedades de acción.

Se puede especificar un máximo de 32 valores de cadena.

Para obtener más información y una lista de propiedades de acción que pueden usar las variables $(Arg0), $(Arg1), ..., $(Arg32) en sus valores, vea Acciones de tarea.

flags [in]

Constante TASK_RUN_FLAGS que define cómo se ejecuta la tarea.

sessionID [in]

Sesión de terminal server en la que desea iniciar la tarea.

Si la constante TASK_RUN_USE_SESSION_ID (0x4) no se pasa al parámetro flags , se omite el valor especificado en este parámetro. Si la constante TASK_RUN_USE_SESSION_ID se pasa al parámetro flags y el valor sessionID es menor o igual que 0, se devolverá un error de argumento no válido.

Si la constante TASK_RUN_USE_SESSION_ID se pasa al parámetro flags y el valor sessionID es un identificador de sesión válido mayor que 0 y, si no se especifica ningún valor para el parámetro de usuario , el servicio Programador de tareas intentará iniciar la tarea de forma interactiva como el usuario que ha iniciado sesión en la sesión especificada.

Si la constante TASK_RUN_USE_SESSION_ID se pasa al parámetro flags y el valor sessionID es un identificador de sesión válido mayor que 0 y si se especifica un usuario en el parámetro user, el servicio Programador de tareas intentará iniciar la tarea de forma interactiva como el usuario que se especifica en el parámetro user .

runningTask [out]

Objeto RunningTask que define la nueva instancia de la tarea.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Este método devolverá sin errores, pero la tarea no se ejecutará si la propiedad TaskSettings.AllowDemandStart está establecida en false para la tarea registrada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Biblioteca de tipos	Taskschd.tlb
Archivo DLL	Taskschd.dll

Consulte también

Programador de tareas

RegisteredTask