Compartir a través de


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
S_OK
La operación se realizó correctamente.
ERROR_FILE_EXISTS
Ya existe una tarea con el nombre especificado. El valor devuelto real es HRESULT_FROM_WIN32(ERROR_FILE_EXISTS).
E_INVALIDARG
Uno o varios de los argumentos no son válidos.
E_OUTOFMEMORY
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

Consulte también

IScheduledWorkItem

ITaskScheduler

ITaskScheduler::NewWorkItem