Compartir a través de


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

Obtiene una colección de tareas en ejecución.

NotaITaskService::GetRunningTasks solo devolverá una colección de tareas en ejecución que se ejecutan en o debajo del contexto de seguridad de un usuario. Por ejemplo, para los miembros del grupo Administradores, GetRunningTasks devolverá una colección de todas las tareas en ejecución, pero para los miembros del grupo Usuarios, GetRunningTasks solo devolverá una colección de tareas que se ejecutan en el contexto de seguridad del grupo Usuarios.

 

Sintaxis

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

Parámetros

[in] flags

Valor de la enumeración TASK_ENUM_FLAGS . Pase 0 para devolver una colección de tareas en ejecución que no son tareas ocultas.

[out] ppRunningTasks

Interfaz IRunningTaskCollection que contiene las tareas que se están ejecutando actualmente.

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.

Descripción
E_INVALIDARG
Se especificó un argumento no válido en la llamada al método . Al pasar un valor distinto de cero al parámetro flags , se devolverá E_INVALIDARG.
S_OK
La operación se ha completado correctamente.
E_POINTER
NULL se pasó al parámetro retVal .
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)
El usuario no se ha conectado al servicio.

Requisitos

Requisito Value
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

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

Programador de tareas