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 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.

	Descripción
E_INVALIDARG	Se especificó un argumento no válido en la llamada al método . Pasar un valor distinto de cero a las marcas parámetro devolverá E_INVALIDARG.
S_OK	La operación se completó 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	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

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

programador de tareas de