ITask::SetMaxRunTime-Methode (mstask.h)

[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]

Diese Methode legt die maximale Ausführungszeit der Aufgabe in Millisekunden vor dem Beenden fest.

Syntax

HRESULT SetMaxRunTime(
  [in] DWORD dwMaxRunTimeMS
);

Parameter

[in] dwMaxRunTimeMS

Ein DWORD-Wert , der die maximale Laufzeit (in Millisekunden) für den Task angibt. Dieser Parameter kann auf INFINITE festgelegt werden, um eine unbegrenzte Zeit anzugeben.

Rückgabewert

Die SetMaxRunTime-Methode gibt einen der folgenden Werte zurück.

Hinweise

Wenn die maximale Laufzeit überschritten wird, versucht der Taskplaner, die der Aufgabe zugeordnete Anwendung zu beenden. Wenn eine WM_CLOSE Nachricht nicht gesendet werden kann (z. B. wenn die Anwendung über keine Fenster verfügt) oder die Anwendung nicht innerhalb von drei Minuten nach dem Empfangen der WM_CLOSE beendet wurde, beendet der Taskplaner die Anwendung mithilfe von TerminateProcess.

Nachdem Sie die maximale Laufzeit festgelegt haben, müssen Sie IPersistFile::Save aufrufen, um das geänderte Aufgabenobjekt auf dem Datenträger zu speichern.

Beispiele

Ein Beispiel zum Festlegen der maximalen Laufzeit finden Sie unter C/C++-Codebeispiel: Festlegen von MaxRunTime.

Anforderungen

Weitere Informationen

IGetMaxRunTime

Itask