Méthode RegisteredTask.RunEx

Pour les scripts, exécute immédiatement la tâche inscrite à l’aide d’indicateurs spécifiés et d’un identificateur de session.

Syntaxe

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

Paramètres

params [in]

Paramètres utilisés comme valeurs dans les actions de tâche. Pour ne spécifier aucune valeur de paramètre pour les actions de tâche, définissez ce paramètre sur Nothing. Sinon, une valeur de chaîne unique ou un tableau de valeurs de chaîne peut être spécifié.

Les valeurs de chaîne que vous spécifiez sont associées à des noms et stockées sous forme de paires nom-valeur. Si vous spécifiez une valeur de chaîne unique, Arg0 sera le nom attribué à la valeur. La valeur peut être utilisée dans l’action de tâche où la variable $(Arg0) est utilisée dans les propriétés de l’action.

Si vous transmettez des valeurs telles que « 0 », « 100 » et « 250 » en tant que tableau de valeurs de chaîne, « 0 » remplace les variables $(Arg0), « 100 » remplace les variables $(Arg1) et « 250 » remplace les variables $(Arg2) utilisées dans les propriétés d’action.

Un maximum de 32 valeurs de chaîne peut être spécifié.

Pour plus d’informations et pour obtenir la liste des propriétés d’action qui peuvent utiliser les variables $(Arg0), $(Arg1), ..., $(Arg32) dans leurs valeurs, consultez Actions de tâche.

indicateurs [in]

Constante TASK_RUN_FLAGS qui définit la façon dont la tâche est exécutée.

sessionID [in]

Session terminal server dans laquelle vous souhaitez lancer la tâche.

Si la constante TASK_RUN_USE_SESSION_ID (0x4) n’est pas passée dans le paramètre flags , la valeur spécifiée dans ce paramètre est ignorée. Si la constante TASK_RUN_USE_SESSION_ID est passée dans le paramètre flags et que la valeur sessionID est inférieure ou égale à 0, une erreur d’argument non valide est retournée.

Si la constante TASK_RUN_USE_SESSION_ID est passée dans le paramètre flags et si la valeur sessionID est un ID de session valide supérieur à 0 et si aucune valeur n’est spécifiée pour le paramètre utilisateur , le service Planificateur de tâches tente de lancer la tâche de manière interactive en tant qu’utilisateur connecté à la session spécifiée.

Si la constante TASK_RUN_USE_SESSION_ID est passée dans le paramètre flags et que la valeur sessionID est un ID de session valide supérieur à 0 et si un utilisateur est spécifié dans le paramètre utilisateur , le service Planificateur de tâches tente de lancer la tâche de manière interactive en tant qu’utilisateur spécifié dans le paramètre utilisateur .

runningTask [out]

Objet RunningTask qui définit la nouvelle instance de la tâche.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Cette méthode retourne sans erreur, mais la tâche ne s’exécute pas si la propriété TaskSettings.AllowDemandStart a la valeur false pour la tâche inscrite.

Spécifications

Voir aussi

Planificateur de tâches

RegisteredTask