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

Artigo
07/16/2024

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

Compartilhar via