Método IScheduledWorkItem::Terminate (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 encerra a execução do item de trabalho.

Sintaxe

HRESULT Terminate();

Retornar valor

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

O método Terminate opera de forma assíncrona. Ele não aguarda que a tarefa seja encerrada antes de retornar um valor retornado.

Se a 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.

Exemplos

Para obter um exemplo de como recuperar a tarefa status e encerrar uma tarefa, consulte Encerrando um exemplo de tarefa.

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

IScheduledWorkItem

Itask