RegisteredTask.RunEx-Methode
Führt für die Skripterstellung die registrierte Aufgabe sofort mithilfe der angegebenen Flags und eines Sitzungsbezeichners aus.
Syntax
RegisteredTask.RunEx( _
ByVal params, _
ByVal flags, _
ByVal sessionID, _
ByRef runningTask _
)
Parameter
-
params [ In]
-
Die Parameter, die als Werte in den Taskaktionen verwendet werden. Um keine Parameterwerte für die Taskaktionen anzugeben, legen Sie diesen Parameter auf Nothing fest. Andernfalls kann ein einzelner Zeichenfolgenwert oder ein Array von Zeichenfolgenwerten angegeben werden.
Die von Ihnen angegebenen Zeichenfolgenwerte werden mit Namen gekoppelt und als Name-Wert-Paare gespeichert. Wenn Sie einen einzelnen Zeichenfolgenwert angeben, ist Arg0 der Dem Wert zugewiesene Name. Der Wert kann in der Taskaktion verwendet werden, bei der die $(Arg0)-Variable in den Aktionseigenschaften verwendet wird.
Wenn Sie Werte wie "0", "100" und "250" als Array von Zeichenfolgenwerten übergeben, ersetzt "0" die $(Arg0)-Variablen, "100" die $(Arg1)-Variablen und "250" die $(Arg2)-Variablen, die in den Aktionseigenschaften verwendet werden.
Es können maximal 32 Zeichenfolgenwerte angegeben werden.
Weitere Informationen und eine Liste der Aktionseigenschaften, die $(Arg0), $(Arg1), ..., $(Arg32) Variablen in ihren Werten verwenden können, finden Sie unter Aufgabenaktionen.
-
Flags [ In]
-
Eine TASK _ RUN _ FLAGS-Konstante, die definiert, wie der Task ausgeführt wird.
-
sessionID [ In]
-
Die Terminalserversitzung, in der Sie die Aufgabe starten möchten.
Wenn die _ TASK RUN USE SESSION _ _ _ ID-Konstante (0x4) nicht an den flags-Parameter übergeben wird, wird der in diesem Parameter angegebene Wert ignoriert. Wenn die _ TASK RUN USE SESSION _ _ _ ID-Konstante an den flags-Parameter übergeben wird und der sessionID-Wert kleiner oder gleich 0 ist, wird ein ungültiger Argumentfehler zurückgegeben.
Wenn die _ TASK RUN USE SESSION _ _ _ ID-Konstante an den flags-Parameter übergeben wird und der sessionID-Wert eine gültige Sitzungs-ID größer als 0 ist und kein Wert für den Benutzerparameter angegeben ist, versucht der Taskplaner Dienst, die Aufgabe interaktiv als Benutzer zu starten, der an der angegebenen Sitzung angemeldet ist.
Wenn die _ TASK RUN USE SESSION _ _ _ ID-Konstante an den flags-Parameter übergeben wird und der sessionID-Wert eine gültige Sitzungs-ID größer als 0 ist und ein Benutzer im Benutzerparameter angegeben ist, versucht der Taskplaner Dienst, die Aufgabe interaktiv als benutzerspezifischen Benutzer zu starten.
-
runningTask [ out]
-
Ein RunningTask-Objekt, das die neue Instanz des Tasks definiert.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Bemerkungen
Diese Methode gibt ohne Fehler zurück, aber die Aufgabe wird nicht ausgeführt, wenn die TaskSettings.AllowDemandStart-Eigenschaft für den registrierten Task auf FALSE festgelegt ist.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Typbibliothek |
|
| DLL |
|