Compartilhar via


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

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

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

Sintaxe

HRESULT GetMaxRunTime(
  [out] DWORD *pdwMaxRunTimeMS
);

Parâmetros

[out] pdwMaxRunTimeMS

Um ponteiro para um DWORD que contém o tempo de execução máximo da tarefa atual.

Se o tempo de execução máximo for atingido durante a execução de uma tarefa, o Agendador de Tarefas primeiro enviará uma mensagem WM_CLOSE ao aplicativo associado. Se o aplicativo não sair dentro de três minutos, TerminateProcess será executado.

Retornar valor

O método GetMaxRunTime 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.

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

Itask

SetMaxRunTime