Método IShellTaskScheduler::AddTask (shobjidl_core.h)

Agrega una tarea a la cola en segundo plano del programador.

Sintaxis

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

Parámetros

[in] prt

Tipo: IRunnableTask*

Puntero a una instancia de una interfaz IRunnableTask que representa la tarea que se va a agregar a la cola.

[in] rtoid

Tipo: REFTASKOWNERID

GUID que identifica al propietario de la tarea. Esta información se puede usar para agrupar tareas para su posterior recuento o eliminación por propietario.

[in] lParam

Tipo: DWORD_PTR

Puntero a un valor DWORD definido por el usuario que permite identificar la tarea dentro de las tareas que pertenecen a rtoid. Se usa para identificar tareas únicas o para agruparlas, por ejemplo, asociando la tarea con un elemento determinado, como un elemento de un control ListView. Este parámetro puede ser cero.

[in] dwPriority

Tipo: DWORD

Uno de los siguientes valores asignando la prioridad de la tarea. La respuesta a esta prioridad depende de la cooperación de las demás tareas que se ejecutan. Las nuevas tareas se insertan en la cola en orden de prioridad. Si una tarea de prioridad baja está actualmente en ejecución cuando se agrega una tarea de mayor prioridad, el programador intenta suspender la tarea en ejecución. Esa tarea de menor prioridad se reanuda cuando se completan las tareas de mayor prioridad.

ITSAT_DEFAULT_PRIORITY

Acepte la prioridad predeterminada asignada a la tarea por el programador.

ITSAT_MAX_PRIORITY

Prioridad alta.

ITSAT_MIN_PRIORITY

Prioridad baja.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL	Shell32.dll (versión 5.0 o posterior)