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

  • Artículo

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

NotaIRegisteredTask::GetInstances solo devolverá instancias de la tarea registrada que se está ejecutando actualmente en el contexto de seguridad de un usuario o debajo de este. 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 actualmente en ejecución 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 interfaz IRunningTaskCollectionNULL. Hacer referencia a un puntero distinto de NULL puede provocar una pérdida de memoria porque el puntero se sobrescribirá.

Valor devuelto

Este método puede devolver uno de estos valores.

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

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado taskschd.h
Library Taskschd.lib
Archivo DLL Taskschd.dll

Consulte también

IRegisteredTask

IRunningTaskCollection

Programador de tareas