Freigeben über


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