Método IEnumWorkItems::Next (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 . ]
Recupera el siguiente número especificado de tareas en la secuencia de enumeración.
Si hay menos que el número solicitado de tareas que quedan en la secuencia, se recuperan todos los elementos restantes.
Sintaxis
HRESULT Next(
[in] ULONG celt,
[out] LPWSTR **rgpwszNames,
[out] ULONG *pceltFetched
);
Parámetros
[in] celt
Número de tareas que se van a recuperar.
[out] rgpwszNames
Puntero a una matriz de punteros (LPWSTR) a cadenas de caracteres terminadas en NULL que contienen los nombres de archivo de las tareas devueltas de la secuencia de enumeración. Estos nombres de archivo se toman de la carpeta Tareas programadas y tienen la extensión ".job".
Después de procesar los nombres devueltos en rgpwszNames, primero debe liberar cada cadena de caracteres de la matriz y, a continuación, la propia matriz mediante CoTaskMemFree.
[out] pceltFetched
Puntero al número de tareas devueltas en rgpwszNames. Si el parámetro celt es 1, este parámetro puede ser NULL.
Valor devuelto
Devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
El número de tareas recuperadas es igual al número solicitado. |
|
El número devuelto es menor que el número solicitado. (Por lo tanto, no hay más tareas que enumerar). |
|
Si se devuelve este valor, significará que el parámetro en cuestión no es válido. |
|
No hay suficiente memoria disponible. |
Comentarios
La interfaz IEnumWorkItems también proporciona métodos para restablecer la enumeración, omitir tareas y realizar una copia del estado actual de la enumeración.
Ejemplos
Para obtener un ejemplo de cómo usar Next para enumerar las tareas de la carpeta Tareas programadas, vea Ejemplo de enumeración de tareas.
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 |