Compartir a través de

Método IRegisteredTask::Run (taskschd.h)

  • Artículo

Ejecuta la tarea registrada inmediatamente.

Sintaxis

HRESULT Run(
  [in]            VARIANT      params,
  [out, optional] IRunningTask **ppRunningTask
);

Parámetros

[in] params

Los 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 VT_NULL o VT_EMPTY. De lo contrario, se puede especificar una sola valor BSTR o una matriz de valores de BSTR.

Los valores de BSTR que especifique se emparejan con nombres y se almacenan como pares nombre-valor. Si especifica un solo valor de BSTR, 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 BSTR, "0" reemplazará las variables $(Arg0), "100" reemplazará las variables $(Arg1) y "250" reemplazará las variables $(Arg2) que se usan en las propiedades de acción.

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

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

[out, optional] ppRunningTask

Interfaz IRunningTask que define la nueva instancia de la tarea.

Pase una referencia a un puntero de interfazIRunningTask NULL. Hacer referencia a un puntero null nopuede provocar una pérdida de memoria porque se sobrescribirá el puntero.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

Este método devolverá sin error, pero la tarea no se ejecutará si la propiedad AllowDemandStart de ITaskSettings está establecida en false para la tarea.

La función IRegisteredTask::Run es equivalente a la función IRegisteredTask::Run Ex con el parámetro flags igual a 0 y el parámetro user igual a NULL.

Si IRegisteredTask::Run se invoca desde una tarea deshabilitada, devolverá SCHED_E_TASK_DISABLED.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de taskschd.h
biblioteca de Taskschd.lib
DLL de Taskschd.dll

Consulte también

IRegisteredTask

programador de tareas de