Compartilhar via

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

  • Last updated on