Método ITaskScheduler::AddWorkItem (mstask.h)
[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o del producto. Use las interfaces del Programador de tareas 2.0 en su lugar. ]
El método AddWorkItem agrega una tarea a la programación de tareas.
Sintaxis
HRESULT AddWorkItem(
[in] LPCWSTR pwszTaskName,
[in] IScheduledWorkItem *pWorkItem
);
Parámetros
[in] pwszTaskName
Cadena terminada en null que especifica el nombre de la tarea que se va a agregar. El nombre de la tarea debe cumplir las convenciones de nomenclatura de archivos de Windows NT, pero no puede incluir barras diagonales inversas porque no se permite el anidamiento dentro del objeto de carpeta de tareas.
[in] pWorkItem
Puntero a la tarea que se va a agregar a la programación.
Valor devuelto
El método AddWorkItem devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
Ya existe una tarea con el nombre especificado. El valor devuelto real es HRESULT_FROM_WIN32(ERROR_FILE_EXISTS). |
|
Uno o varios de los argumentos no son válidos. |
|
Memoria insuficiente para completar la operación. |
Comentarios
El programador de tareas proporciona dos métodos para agregar elementos de trabajo: NewWorkItem y AddWorkItem. De estos métodos, cada uno tiene su ventaja específica. AddWorkItem evita colisiones de nomenclatura, pero también requiere dos operaciones de escritura de disco por llamada. Una operación de escritura se realiza cuando la llamada a AddWorkItem crea un objeto de elemento de trabajo vacío en el disco, seguido de otra operación de escritura cuando se llama a IPersistFile::Save .
NewWorkItem no impide conflictos de nomenclatura, pero solo requiere una operación de escritura de disco cuando se llama a IPersistFile::Save . Aunque NewWorkItem es más eficaz con las operaciones de escritura en disco, la aplicación corre el riesgo de que otra aplicación cree un elemento de trabajo con el mismo nombre antes de que se realice la llamada a IPersistFile::Save .
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 |