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.

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

Vedi anche

IGetMaxRunTime

Itask