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