ITaskSettings-Schnittstelle (taskschd.h)

Stellt die Einstellungen bereit, die der Taskplanerdienst zum Ausführen der Aufgabe verwendet.

Vererbung

Die ITaskSettings-Schnittstelle erbt von der IDispatch-Schnittstelle.

Methoden

Die ITaskSettings-Schnittstelle verfügt über diese Methoden.

 
ITaskSettings::get_AllowDemandStart

Ruft einen booleschen Wert ab, der angibt, dass der Task mit dem Befehl Ausführen oder dem Kontextmenü gestartet werden kann, oder legt diesen fest. (Abrufen)
ITaskSettings::get_AllowHardTerminate

Ruft einen booleschen Wert ab, der angibt, dass der Task möglicherweise vom Taskplanerdienst mit TerminateProcess beendet wird, oder legt diesen fest. (Abrufen)
ITaskSettings::get_Compatibility

Ruft einen ganzzahligen Wert ab, der angibt, mit welcher Version des Aufgabenplaner eine Aufgabe kompatibel ist, oder legt diesen fest. (Abrufen)
ITaskSettings::get_DeleteExpiredTaskAfter

Ruft die Zeitspanne ab, die der Taskplaner wartet, bevor der Task nach Ablauf des Vorgangs gelöscht wird, oder legt diesen fest. (Abrufen)
ITaskSettings::get_DisallowStartIfOnBatteries

Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe nicht gestartet wird, wenn der Computer mit Batterien ausgeführt wird, oder legt diesen fest. (Abrufen)
ITaskSettings::get_Enabled

Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe aktiviert ist, oder legt diesen fest. Die Aufgabe kann nur ausgeführt werden, wenn diese Einstellung True ist.
ITaskSettings::get_ExecutionTimeLimit

Ruft die Zeit ab, die zum Abschließen der Aufgabe zulässig ist, oder legt diesen fest. (Abrufen)
ITaskSettings::get_Hidden

Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe auf der Benutzeroberfläche nicht sichtbar ist, oder legt diesen fest. (Abrufen)
ITaskSettings::get_IdleSettings

Ruft die Informationen ab, die angeben, wie der Aufgabenplaner Aufgaben ausführt, wenn sich der Computer im Leerlauf befindet, oder legt sie fest. (Abrufen)
ITaskSettings::get_MultipleInstances

Ruft die Richtlinie ab, die definiert, wie der Aufgabenplaner mit mehreren Instanzen des Tasks umgeht, oder legt diese fest. (Abrufen)
ITaskSettings::get_NetworkSettings

Ruft das Netzwerkeinstellungsobjekt ab, das einen Netzwerkprofilbezeichner und -namen enthält, oder legt es fest. (Abrufen)
ITaskSettings::get_Priority

Ruft die Prioritätsebene des Vorgangs ab oder legt diese fest. (Abrufen)
ITaskSettings::get_RestartCount

Ruft die Häufigkeit ab, mit der der Taskplaner versucht, den Task neu zu starten, oder legt diese fest. (Abrufen)
ITaskSettings::get_RestartInterval

Ruft einen Wert ab, der angibt, wie lange der Taskplaner versucht, den Task neu zu starten, oder legt diesen fest. (Abrufen)
ITaskSettings::get_RunOnlyIfIdle

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Task nur dann ausführen wird, wenn sich der Computer im Leerlauf befindet, oder legt diesen fest. (Abrufen)
ITaskSettings::get_RunOnlyIfNetworkAvailable

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Task nur dann ausführen wird, wenn ein Netzwerk verfügbar ist, oder legt diesen fest. (Abrufen)
ITaskSettings::get_StartWhenAvailable

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Task jederzeit starten kann, nachdem die geplante Zeit verstrichen ist, oder legt diesen fest. (Abrufen)
ITaskSettings::get_StopIfGoingOnBatteries

Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe beendet wird, wenn der Computer auf Batterien wechselt, oder legt diesen fest. (Abrufen)
ITaskSettings::get_WakeToRun

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Computer reaktiviert, wenn die Aufgabe ausgeführt werden soll, und hält den Computer wach, bis die Aufgabe abgeschlossen ist. (Abrufen)
ITaskSettings::get_XmlText

Ruft eine XML-formatierte Definition der Aufgabeneinstellungen ab oder legt diese fest. (Abrufen)
ITaskSettings::p ut_AllowDemandStart

Ruft einen booleschen Wert ab, der angibt, dass der Task mit dem Befehl Ausführen oder dem Kontextmenü gestartet werden kann, oder legt diesen fest. (Put)
ITaskSettings::p ut_AllowHardTerminate

Ruft einen booleschen Wert ab, der angibt, dass der Task möglicherweise vom Taskplanerdienst mit TerminateProcess beendet wird, oder legt diesen fest. (Put)
ITaskSettings::p ut_Compatibility

Ruft einen ganzzahligen Wert ab, der angibt, mit welcher Version des Aufgabenplaner eine Aufgabe kompatibel ist, oder legt diesen fest. (Put)
ITaskSettings::p ut_DeleteExpiredTaskAfter

Ruft die Zeitspanne ab, die der Taskplaner wartet, bevor der Task nach Ablauf des Vorgangs gelöscht wird, oder legt diesen fest. (Put)
ITaskSettings::p ut_DisallowStartIfOnBatteries

Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe nicht gestartet wird, wenn der Computer mit Batterien ausgeführt wird, oder legt diesen fest. (Put)
ITaskSettings::p ut_ExecutionTimeLimit

Ruft die Zeit ab, die zum Abschließen der Aufgabe zulässig ist, oder legt diesen fest. (Put)
ITaskSettings::p ut_Hidden

Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe auf der Benutzeroberfläche nicht sichtbar ist, oder legt diesen fest. (Put)
ITaskSettings::p ut_IdleSettings

Ruft die Informationen ab, die angeben, wie der Aufgabenplaner Aufgaben ausführt, wenn sich der Computer im Leerlauf befindet, oder legt sie fest. (Put)
ITaskSettings::p ut_MultipleInstances

Ruft die Richtlinie ab, die definiert, wie der Aufgabenplaner mit mehreren Instanzen des Tasks umgeht, oder legt diese fest. (Put)
ITaskSettings::p ut_NetworkSettings

Ruft das Netzwerkeinstellungsobjekt ab, das einen Netzwerkprofilbezeichner und -namen enthält, oder legt es fest. (Put)
ITaskSettings::p ut_Priority

Ruft die Prioritätsebene des Vorgangs ab oder legt sie fest. (Put)
ITaskSettings::p ut_RestartCount

Ruft ab oder legt fest, wie oft der Taskplaner versucht, den Task neu zu starten. (Put)
ITaskSettings::p ut_RestartInterval

Ruft einen Wert ab, der angibt, wie lange der Taskplaner versucht, den Task neu zu starten, oder legt diesen fest. (Put)
ITaskSettings::p ut_RunOnlyIfIdle

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Task nur dann ausführen wird, wenn sich der Computer im Leerlauf befindet, oder legt diesen fest. (Put)
ITaskSettings::p ut_RunOnlyIfNetworkAvailable

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Task nur dann ausführen wird, wenn ein Netzwerk verfügbar ist, oder legt diesen fest. (Put)
ITaskSettings::p ut_StartWhenAvailable

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Vorgang jederzeit starten kann, nachdem die geplante Zeit verstrichen ist, oder legt diesen fest. (Put)
ITaskSettings::p ut_StopIfGoingOnBatteries

Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe beendet wird, wenn der Computer auf Akkus wechselt, oder legt diesen fest. (Put)
ITaskSettings::p ut_WakeToRun

Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Computer reaktiviert, wenn die Aufgabe ausgeführt werden soll, und hält den Computer wach, bis die Aufgabe abgeschlossen ist. (Put)
ITaskSettings::p ut_XmlText

Ruft eine XML-formatierte Definition der Aufgabeneinstellungen ab oder legt diese fest. (Put)

Hinweise

Standardmäßig wird ein Task 72 Stunden nach dem Start der Ausführung beendet. Sie können dies ändern, indem Sie die Einstellung ExecutionTimeLimit ändern.

Beim Lesen oder Schreiben von XML für einen Vorgang werden die Vorgangseinstellungen im Settings-Element des Aufgabenplanungsschemas definiert.

Wenn der Stromsparmodus aktiviert ist, werden Windows Task Scheduler-Aufgaben nur ausgelöst, wenn die Aufgabe wie folgt lautet:

  • Sie ist nicht so festgelegt, dass die Aufgabe nur gestartet wird, wenn sich der Computer im Leerlauf befindet... (für die Aufgabe wird IdleSettings nicht verwendet)
  • Sie ist nicht so festgelegt, dass während der automatischen Wartung ausgeführt wird (für die Aufgabe wird MaintenanceSettings nicht verwendet)
  • Sie ist auf Nur ausführen, wenn der Benutzer angemeldet ist festgelegt (Aufgabe LogonType ist TASK_LOGON_INTERACTIVE_TOKEN oder TASK_LOGON_GROUP)
Alle anderen Trigger werden verzögert, bis der Stromsparmodus ausgeschaltet ist. Weitere Informationen zum Zugriff auf den Akkusparmodus in Ihrer Anwendung finden Sie unter SYSTEM_POWER_STATUS. Allgemeine Informationen zum Stromsparmodus finden Sie unter Stromsparmodus (in den Richtlinien für Hardwarekomponenten).

Beispiele

Weitere Informationen und ein Codebeispiel für diese Schnittstelle finden Sie unter Time Trigger Example (C++).

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

Weitere Informationen

IIdleSettings

INetworkSettings

ITaskDefinition