RegisteredTask.Run-Methode

Für Skripts führt die registrierte Aufgabe sofort aus.

Syntax

RegisteredTask.Run( _
  ByVal params, _
  ByRef ppRunningTask _
)

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.

ppRunningTask [out]

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

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die RegisteredTask.Run-Funktion entspricht der RegisteredTask.RunEx-Funktion , wobei der Flags-Parameter gleich 0 ist und nichts für den Benutzerparameter angegeben ist.

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