Compartilhar via


Método ITaskSettings::get_ExecutionTimeLimit (taskschd.h)

Obtém ou define a quantidade de tempo que tem permissão para concluir a tarefa. Por padrão, uma tarefa será interrompida 72 horas depois de começar a ser executada. Você pode alterar isso alterando essa configuração.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_ExecutionTimeLimit(
  BSTR *pExecutionTimeLimit
);

Parâmetros

pExecutionTimeLimit

Valor retornado

Nenhum

Comentários

O formato dessa cadeia de caracteres é PnYnMnDTnHnMnS, em que nY é o número de anos, nM é o número de meses, nD é o número de dias, 'T' é o separador de data/hora, nH é o número de horas, nM é o número de minutos e nS é o número de segundos (por exemplo, PT5M especifica 5 minutos e P1M4DT2H5M especifica um mês, quatro dias, duas horas e cinco minutos). Um valor de PT0S permitirá que a tarefa seja executada indefinidamente.

Nota Se uma tarefa for iniciada sob demanda, a configuração ExecutionTimeLimit será ignorada. Portanto, uma tarefa iniciada sob demanda não será encerrada se exceder ExecutionTimeLimit.
 
Ao ler ou gravar XML para uma tarefa, essa configuração é especificada no elemento ExecutionTimeLimit do esquema do Agendador de Tarefas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho taskschd.h
Biblioteca Taskschd.lib
DLL Taskschd.dll

Confira também

ITaskSettings

Agendador de Tarefas