Share via


Método IRegisteredTask::Stop (taskschd.h)

Interrompe a tarefa registrada imediatamente.

Sintaxe

HRESULT Stop(
  [in] LONG flags
);

Parâmetros

[in] flags

Reservado. Deve ser zero.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Todas as instâncias da tarefa registrada em que o usuário tem permissões para parar foram interrompidas.
S_FALSE
O usuário não pode interromper com êxito as instâncias da tarefa.

Comentários

A função IRegisteredTask::Stop interrompe todas as instâncias da tarefa.

Os usuários da conta do sistema podem interromper uma tarefa, os usuários com privilégios de grupo administrador podem interromper uma tarefa e, se um usuário tiver direitos de executar e ler uma tarefa, o usuário poderá interromper a tarefa. Um usuário pode interromper as instâncias de tarefa que estão em execução sob as mesmas credenciais que a conta de usuário. Em todos os outros casos, o usuário tem acesso negado para interromper a tarefa.

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

IRegisteredTask