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.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde durchgeführt.
E_INVALIDARG	Die Argumente sind ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mstask.h
Bibliothek	Mstask.lib
DLL	Mstask.dll
Verteilbare Komponente	Internet Explorer 4.0 oder höher unter Windows NT 4.0 und Windows 95

Weitere Informationen

IGetMaxRunTime

Itask