Método RegisteredTask.RunEx

Para scripts, executa a tarefa registrada imediatamente usando sinalizadores especificados e um identificador de sessão.

Sintaxe

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

Parâmetros

params [in]

Os parâmetros usados como valores nas ações da tarefa. Para não especificar nenhum valor de parâmetro para as ações de tarefa, defina esse parâmetro como Nothing. Caso contrário, um único valor de cadeia de caracteres ou uma matriz de valores de cadeia de caracteres pode ser especificado.

Os valores de cadeia de caracteres especificados são emparelhados com nomes e armazenados como pares nome-valor. Se você especificar um único valor de cadeia de caracteres, Arg0 será o nome atribuído ao valor. O valor pode ser usado na ação da tarefa em que a variável $(Arg0) é usada nas propriedades da ação.

Se você passar valores como "0", "100" e "250" como uma matriz de valores de cadeia de caracteres, "0" substituirá as variáveis $(Arg0), "100" substituirá as variáveis $(Arg1) e "250" substituirá as variáveis $(Arg2) usadas nas propriedades da ação.

Um máximo de 32 valores de cadeia de caracteres pode ser especificado.

Para obter mais informações e uma lista de propriedades de ação que podem usar variáveis $(Arg0), $(Arg1), ..., $(Arg32) em seus valores, consulte Ações de Tarefa.

sinalizadores [in]

Uma constante TASK_RUN_FLAGS que define como a tarefa é executada.

sessionID [in]

A sessão do servidor de terminal na qual você deseja iniciar a tarefa.

Se a constante TASK_RUN_USE_SESSION_ID (0x4) não for passada para o parâmetro flags , o valor especificado nesse parâmetro será ignorado. Se a constante TASK_RUN_USE_SESSION_ID for passada para o parâmetro flags e o valor sessionID for menor ou igual a 0, um erro de argumento inválido será retornado.

Se a constante TASK_RUN_USE_SESSION_ID for passada para o parâmetro flags e o valor sessionID for uma ID de sessão válida maior que 0 e se nenhum valor for especificado para o parâmetro de usuário , o serviço Agendador de Tarefas tentará iniciar a tarefa interativamente como o usuário conectado à sessão especificada.

Se a constante TASK_RUN_USE_SESSION_ID for passada para o parâmetro flags e o valor sessionID for uma ID de sessão válida maior que 0 e se um usuário for especificado no parâmetro de usuário , o serviço Agendador de Tarefas tentará iniciar a tarefa interativamente como o usuário especificado no parâmetro de usuário .

runningTask [out]

Um objeto RunningTask que define a nova instância da tarefa.

Valor retornado

Esse método não retorna um valor.

Comentários

Esse método retornará sem erro, mas a tarefa não será executada se a propriedade TaskSettings.AllowDemandStart estiver definida como false para a tarefa registrada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Biblioteca de tipos	Taskschd.tlb
DLL	Taskschd.dll

Confira também

Agendador de Tarefas

RegisteredTask