IRegisteredTask::Run-Methode (taskschd.h)

Führt den registrierten Task 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. Um keine Parameterwerte für die Aufgabenaktionen anzugeben, legen Sie diesen Parameter auf VT_NULL oder VT_EMPTY fest. Andernfalls kann ein einzelner BSTR-Wert oder ein Array von BSTR-Werten angegeben werden.

Die von Ihnen angegebenen BSTR-Werte werden mit Namen gekoppelt und als Name-Wert-Paare gespeichert. Wenn Sie einen einzelnen BSTR-Wert angeben, ist Arg0 der Dem Wert zugewiesene Name. Der Wert kann in der Vorgangsaktion verwendet werden, bei 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 $(Arg0)-Variablen, "100" die Variablen $(Arg1) und "250" die $(Arg2)-Variablen, die in den Aktionseigenschaften verwendet werden.

Es können maximal 32 BSTR-Werte 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.

[out, optional] ppRunningTask

Eine IRunningTask-Schnittstelle, die die neue instance 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_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

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

Die IRegisteredTask::Run-Funktion entspricht der Funktion IRegisteredTask::RunEx , wobei der Flags-Parameter gleich 0 und der Benutzerparameter gleich NULL ist.

Wenn IRegisteredTask::Run von einem deaktivierten Task aufgerufen wird, wird SCHED_E_TASK_DISABLED zurückgegeben.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	taskschd.h
Bibliothek	Taskschd.lib
DLL	Taskschd.dll

Weitere Informationen

IRegisteredTask

Aufgabenplanung