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

Artigo
08/24/2023

O método IEnumTASK::Next permite que o MMC recupere a próxima tarefa na lista de tarefas do snap-in.

Sintaxe

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

Parâmetros

[in] celt

Um valor que especifica o número de tarefas a serem fornecidas. O MMC sempre enumera tarefas uma de cada vez; portanto, celt é sempre 1.

[out] rgelt

Um ponteiro para uma estrutura MMC_TASK que o snap-in preenche para representar a tarefa a ser adicionada ao bloco de tarefas. Lembre-se de que o chamador (MMC) aloca a memória para a estrutura.

[out] pceltFetched

Um ponteiro para um valor que especifica o número de tarefas retornadas. Se o snap-in tiver retornado com êxito uma ou mais tarefas, defina o valor como o número de tarefas que foram retornadas com êxito. Como o MMC sempre solicita uma tarefa por vez (celt é sempre 1), pceltFetched deve ser definido como 1 se a tarefa tiver sido retornada com êxito. Se o snap-in não tiver mais tarefas em sua lista ou se o snap-in não conseguir preencher a estrutura MMC_TASK, defina o valor como 0.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

O MMC chama esse método para enumerar a lista de tarefas que o snap-in deve adicionar ao bloco de tarefas. O MMC chama esse método até que ele retorne S_FALSE para indicar que não há mais tarefas para o snap-in adicionar ao bloco de tarefas.