Compartir a través de

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

Devuelve todas las instancias de la tarea registrada actualmente en ejecución.

NotaIRegisteredTask::GetInstances solo devolverá instancias de la tarea registrada actualmente en ejecución que se ejecuta en o debajo del contexto de seguridad de un usuario. Por ejemplo, para los miembros del grupo Administradores, GetInstances devolverá todas las instancias de la tarea registrada actualmente en ejecución, pero para los miembros del grupo Usuarios, GetInstances solo devolverá instancias de la tarea registrada que se ejecuta actualmente que se ejecuta en el contexto de seguridad del grupo Usuarios.

 

Sintaxis

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

Parámetros

flags

Este parámetro está reservado para uso futuro y debe establecerse en 0.

[out] ppRunningTasks

Interfaz IRunningTaskCollection que contiene todas las instancias actualmente en ejecución de la tarea en el contexto del usuario.

Pase una referencia a un puntero de interfazIRunningTaskCollection NULL. Hacer referencia a un puntero null nopuede provocar una pérdida de memoria porque se sobrescribirá el puntero.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 La operación se completó correctamente.
E_INVALIDARG
 Se pasó una marca que no es NULL al parámetro marcas.
E_POINTER
 NULL se pasó al parámetro ppRunningTasks.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de taskschd.h
biblioteca de Taskschd.lib
DLL de Taskschd.dll

Consulte también

IRegisteredTask

IRunningTaskCollection

programador de tareas de

  • Last updated on