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 diese 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 der Aufgabe 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 diese 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

Anforderung	Wert
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