RegisteredTask.RunEx-Methode

Führt für skripterstellung den registrierten Task sofort unter Verwendung 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 Aufgabenaktionen verwendet werden. Um keine Parameterwerte für die Aufgabenaktionen 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 Name, der dem Wert zugewiesen ist. Der Wert kann in der Taskaktion verwendet werden, in der die Variable $(Arg0) 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 in den Aktionseigenschaften verwendeten Variablen $(Arg2).

Es können maximal 32 Zeichenfolgenwerte angegeben werden.

Weitere Informationen und eine Liste der Aktionseigenschaften, die die Variablen $(Arg0), $(Arg1), ..., $(Arg32) 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 Konstanten (0x4) nicht an den Flags-Parameter übergeben wird, wird der in diesem Parameter angegebene Wert ignoriert. Wenn die TASK_RUN_USE_SESSION_ID Konstanten an den Flags-Parameter übergeben wird und der Wert von sessionID 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 wird, versucht der Taskplaner-Dienst, die Aufgabe interaktiv als der Benutzer zu starten, der bei 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 der Benutzer zu starten, der im Benutzerparameter angegeben ist.

runningTask [out]

Ein RunningTask-Objekt, das die neue instance der Aufgabe definiert.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Diese Methode gibt ohne Fehler zurück, aber der Task wird nicht ausgeführt, wenn die TaskSettings.AllowDemandStart-Eigenschaft für den registrierten Task auf false festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Typbibliothek	Taskschd.tlb
DLL	Taskschd.dll

Siehe auch

Aufgabenplanung

RegisteredTask