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 |
---|---|
|
La operación se realizó correctamente. Se envió la solicitud. Para obtener más información, vea la sección Comentarios. |
|
Los argumentos no son válidos. |
|
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 |