Método ITask::SetMaxRunTime (mstask.h)

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou do produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

Esse método define o tempo máximo que a tarefa pode executar, em milissegundos, antes de terminar.

Sintaxe

HRESULT SetMaxRunTime(
  [in] DWORD dwMaxRunTimeMS
);

Parâmetros

[in] dwMaxRunTimeMS

Um valor DWORD que especifica o tempo de execução máximo (em milissegundos) para a tarefa. Esse parâmetro pode ser definido como INFINITE para especificar um tempo ilimitado.

Retornar valor

O método SetMaxRunTime retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_INVALIDARG	Os argumentos não são válidos.
E_OUTOFMEMORY	Não existe memória suficiente.

Comentários

Quando o tempo máximo de execução é excedido, o Agendador de Tarefas tenta encerrar o aplicativo associado à tarefa. Se uma mensagem WM_CLOSE não puder ser enviada (por exemplo, o aplicativo não tiver janelas) ou o aplicativo não tiver sido encerrado dentro de três minutos após o recebimento WM_CLOSE, o Agendador de Tarefas encerrará o aplicativo usando TerminateProcess.

Depois de definir o tempo de execução máximo, chame IPersistFile::Save para salvar o objeto de tarefa modificado no disco.

Exemplos

Para obter um exemplo de como definir o tempo de execução máximo, consulte Exemplo de código C/C++: Configurando MaxRunTime.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mstask.h
Biblioteca	Mstask.lib
DLL	Mstask.dll
Redistribuível	Internet Explorer 4.0 ou posterior no Windows NT 4.0 e Windows 95

Confira também

IGetMaxRunTime

Itask