Compartir a través de


Método IScheduledWorkItem::Run (mstask.h)

[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o producto. Use en su lugar las interfaces del Programador de tareas 2.0 . ]

Envía una solicitud al servicio Programador de tareas para ejecutar el elemento de trabajo.

Sintaxis

HRESULT Run();

Valor devuelto

El método Run devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
La operación se realizó correctamente. Se envió la solicitud. Para obtener más información, vea la sección Comentarios.
E_INVALIDARG
Los argumentos no son válidos.
E_OUTOFMEMORY
No hay suficiente memoria disponible.

Comentarios

La ejecución es una operación asincrónica. Un código devuelto de S_OK significa que se ha realizado la solicitud para ejecutar el elemento de trabajo; no significa que el elemento de trabajo haya empezado a ejecutarse. Puede haber un retraso de unos segundos después de que la ejecución se devuelva antes de que el elemento de trabajo empiece a ejecutarse realmente.

Para determinar si el elemento de trabajo se está ejecutando, llame a IScheduledWorkItem::GetStatus.

Ejemplos

Para obtener un ejemplo de cómo iniciar una tarea, vea Iniciar un ejemplo de tarea.

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 mstask.h
Library Mstask.lib
Archivo DLL Mstask.dll
Redistribuible Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95

Consulte también

IScheduledWorkItem

IScheduledWorkItem::GetStatus

ITask