Metodo ITask::SetMaxRunTime (mstask.h)
[[Questa API può essere modificata o non disponibile nelle versioni successive del sistema operativo o del prodotto. Usare invece le interfacce dell'Utilità di pianificazione 2.0 . ]
Questo metodo imposta il tempo massimo di esecuzione dell'attività , espresso in millisecondi, prima di terminare.
Sintassi
HRESULT SetMaxRunTime(
[in] DWORD dwMaxRunTimeMS
);
Parametri
[in] dwMaxRunTimeMS
Valore DWORD che specifica il tempo di esecuzione massimo , espresso in millisecondi, per l'attività. Questo parametro può essere impostato su INFINITE per specificare un tempo illimitato.
Valore restituito
Il metodo SetMaxRunTime restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Gli argomenti non sono validi. |
|
Memoria insufficiente. |
Commenti
Quando viene superato il tempo di esecuzione massimo, l'Utilità di pianificazione tenta di terminare l'applicazione associata all'attività. Se non è possibile inviare un messaggio di WM_CLOSE (ad esempio, l'applicazione non ha finestre) o l'applicazione non è stata chiusa entro tre minuti dal WM_CLOSE ricevente, l'Utilità di pianificazione termina l'applicazione usando TerminateProcess.
Dopo aver impostato il tempo di esecuzione massimo, assicurarsi di chiamare IPersistFile::Save per salvare l'oggetto attività modificato su disco.
Esempio
Per un esempio di come impostare il tempo di esecuzione massimo, vedere Esempio di codice C/C++: Impostazione di MaxRunTime.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mstask.h |
| Libreria | Mstask.lib |
| DLL | Mstask.dll |
| Componente ridistribuibile | Internet Explorer 4.0 o versione successiva in Windows NT 4.0 e Windows 95 |