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

Retorna todas as instâncias da tarefa registrada atualmente em execução.

ObservaçãoIRegisteredTask::GetInstances retornará apenas instâncias da tarefa registrada atualmente em execução em execução no contexto de segurança de um usuário ou abaixo. Por exemplo, para membros do grupo Administradores, GetInstances retornará todas as instâncias da tarefa registrada atualmente em execução, mas para membros do grupo Usuários, GetInstances retornará apenas instâncias da tarefa registrada atualmente em execução que estão em execução no contexto de segurança do grupo Usuários.

 

Sintaxe

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

Parâmetros

flags

Esse parâmetro é reservado para uso futuro e deve ser definido como 0.

[out] ppRunningTasks

Uma interface IRunningTaskCollection que contém todas as instâncias em execução atualmente da tarefa no contexto do usuário.

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.

Código de retorno	Descrição
S_OK	A operação foi concluída com êxito.
E_INVALIDARG	Um sinalizador não nulo foi passado para os sinalizadores parâmetro.
E_POINTER	NULL foi passado para o parâmetro ppRunningTasks .

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

IRegisteredTask

IRunningTaskCollection

do Agendador de Tarefas