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
S_OK	L'operazione è stata completata.
E_INVALIDARG	Gli argomenti non sono validi.
E_OUTOFMEMORY	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

Vedi anche

IGetMaxRunTime

Itask