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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Die Argumente sind ungültig. |
|
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 |