Método RegisteredTask.Run
Para scripts, executa a tarefa registrada imediatamente.
Sintaxe
RegisteredTask.Run( _
ByVal params, _
ByRef ppRunningTask _
)
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.
-
ppRunningTask [out]
-
Um objeto RunningTask que define a nova instância da tarefa.
Valor retornado
Esse método não retorna um valor.
Comentários
A função RegisteredTask.Run é equivalente à função RegisteredTask.RunEx com o parâmetro flags igual a 0 e nada especificado para o parâmetro de usuário.
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 |
|
| DLL |
|