Compartilhar via

Método ITaskService::GetRunningTasks (taskschd.h)

Obtém uma coleção de tarefas em execução.

ObservaçãoITaskService::GetRunningTasks retornará apenas uma coleção de tarefas em execução em execução no contexto de segurança de um usuário ou abaixo. Por exemplo, para membros do grupo Administradores, GetRunningTasks retornará uma coleção de todas as tarefas em execução, mas para membros do grupo Usuários, GetRunningTasks retornará apenas uma coleção de tarefas em execução no contexto de segurança do grupo Usuários.

 

Sintaxe

HRESULT GetRunningTasks(
  [in]  LONG                   flags,
  [out] IRunningTaskCollection **ppRunningTasks
);

Parâmetros

[in] flags

Um valor da enumeração TASK_ENUM_FLAGS. Passe 0 para retornar uma coleção de tarefas em execução que não são tarefas ocultas.

[out] ppRunningTasks

Uma interface IRunningTaskCollection que contém as tarefas em execução no momento.

Passe uma referência a um ponteiro de interfaceNULL IRunningTaskCollection. Fazer referência a um ponteiro NULL nãopode causar um vazamento de memória porque o ponteiro será substituído.

Valor de retorno

Esse método pode retornar um desses valores.

Descrição
E_INVALIDARG
 Um argumento inválido foi especificado na chamada de método. Passar um valor diferente de zero para os sinalizadores de parâmetro retornará E_INVALIDARG.
S_OK
 A operação foi concluída com êxito.
E_POINTER
 NULL foi passado para o parâmetro retVal.
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)
 O usuário não se conectou ao serviço.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho taskschd.h
biblioteca Taskschd.lib
de DLL Taskschd.dll

Consulte também

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

do Agendador de Tarefas

  • Last updated on