IRegisteredTask::Run-Methode (taskschd.h)

Führt den registrierten Vorgang sofort aus.

Syntax

HRESULT Run(
  [in]            VARIANT      params,
  [out, optional] IRunningTask **ppRunningTask
);

Parameter

[in] params

Die Parameter, die als Werte in den Aufgabenaktionen verwendet werden. Wenn Sie keine Parameterwerte für die Aufgabenaktionen angeben möchten, legen Sie diesen Parameter auf VT_NULL oder VT_EMPTYfest. Andernfalls kann ein einzelner BSTR- Wert oder ein Array mit BSTR--Werten angegeben werden.

Die BSTR- Werte, die Sie angeben, werden mit Namen gekoppelt und als Name-Wert-Paare gespeichert. Wenn Sie einen einzelnen BSTR--Wert angeben, ist Arg0 der Name, der dem Wert zugewiesen ist. Der Wert kann in der Aufgabenaktion verwendet werden, in der die Variable $(Arg0) in den Aktionseigenschaften verwendet wird.

Wenn Sie Werte wie "0", "100" und "250" als Array von BSTR- Werten übergeben, ersetzt "0" die Variablen "$(Arg0)," "100" die Variablen "$(Arg1)", und "250" ersetzt die Variablen "$(Arg2)," die in den Aktionseigenschaften verwendeten Variablen.If you pass in values such as "$(0", "100" and "250" will replace the $(Arg2) variables that are used in the action properties.

Es können maximal 32 BSTR- Werte angegeben werden.

Weitere Informationen und eine Liste der Aktionseigenschaften, die $(Arg0), $(Arg1), ..., $(Arg32)-Variablen in ihren Werten verwenden können, finden Sie unter Aufgabenaktionen.

[out, optional] ppRunningTask

Eine IRunningTask- Schnittstelle, die die neue Instanz der Aufgabe definiert.

Übergeben Sie einen Verweis auf einen NULL-IRunningTask Schnittstellenzeiger. Das Verweisen auf einen Nicht-NULL- Zeiger kann zu einem Speicherverlust führen, da der Zeiger überschrieben wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Diese Methode wird ohne Fehler zurückgegeben, aber die Aufgabe wird nicht ausgeführt, wenn die AllowDemandStart- Eigenschaft von ITaskSettings für den Vorgang auf "false" festgelegt ist.

Die funktion IRegisteredTask::Run entspricht der funktion IRegisteredTask::RunEx mit dem Flags-Parameter gleich 0 und dem Benutzerparameter gleich NULL.

Wenn IRegisteredTask::Run von einer deaktivierten Aufgabe aufgerufen wird, wird SCHED_E_TASK_DISABLED zurückgegeben.

Anforderungen

Siehe auch

IRegisteredTask-

Aufgabenplaner-