Método IEnumTASK::Next (mmc.h)

Artículo
08/24/2023

El método IEnumTASK::Next permite a MMC recuperar la siguiente tarea en la lista de tareas del complemento.

Sintaxis

HRESULT Next(
  [in]  ULONG    celt,
  [out] MMC_TASK *rgelt,
  [out] ULONG    *pceltFetched
);

Parámetros

[in] celt

Valor que especifica el número de tareas que se van a proporcionar. MMC siempre enumera las tareas de uno en uno; por lo tanto, celt siempre es 1.

[out] rgelt

Puntero a una estructura de MMC_TASK que el complemento rellena para representar la tarea que se va a agregar al panel de tareas. Tenga en cuenta que el autor de la llamada (MMC) asigna la memoria para la estructura.

[out] pceltFetched

Puntero a un valor que especifica el número de tareas devueltas. Si el complemento devolvió correctamente una o varias tareas, establezca el valor en el número de tareas que se devolvieron correctamente. Dado que MMC siempre solicita una tarea a la vez (celt siempre es 1), pceltFetched debe establecerse en 1 si la tarea se devolvió correctamente. Si el complemento no tiene más tareas en su lista, o si el complemento no puede rellenar la estructura de MMC_TASK, establezca el valor en 0.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

MMC llama a este método para enumerar la lista de tareas que el complemento debe agregar al panel de tareas. MMC llama a este método hasta que devuelve S_FALSE para indicar que no hay más tareas para que el complemento se agregue al panel de tareas.