Método IEnumWorkItems::Next (mstask.h)

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

Recupera o próximo número especificado de tarefas na sequência de enumeração.

Se houver menos do que o número solicitado de tarefas restantes na sequência, todos os elementos restantes serão recuperados.

Sintaxe

HRESULT Next(
  [in]  ULONG  celt,
  [out] LPWSTR **rgpwszNames,
  [out] ULONG  *pceltFetched
);

Parâmetros

[in] celt

O número de tarefas a serem recuperadas.

[out] rgpwszNames

Um ponteiro para uma matriz de ponteiros (LPWSTR) para cadeias de caracteres terminadas em nulo que contêm os nomes de arquivo das tarefas retornadas da sequência de enumeração. Esses nomes de arquivo são retirados da pasta Tarefas Agendadas e têm a extensão ".job".

Depois de processar os nomes retornados em rgpwszNames, primeiro você deve liberar cada cadeia de caracteres na matriz e, em seguida, a própria matriz usando CoTaskMemFree.

[out] pceltFetched

Um ponteiro para o número de tarefas retornadas em rgpwszNames. Se o parâmetro celt for 1, esse parâmetro poderá ser NULL.

Retornar valor

Retorna um dos valores a seguir.

Comentários

A interface IEnumWorkItems também fornece métodos para redefinir a enumeração, ignorar tarefas e fazer uma cópia do estado atual da enumeração.

Exemplos

Para obter um exemplo de como usar Avançar para enumerar as tarefas na pasta Tarefas Agendadas, consulte Exemplo de Enumeração de Tarefas.

Requisitos

Confira também

IEnumWorkItems

IEnumWorkItems::Clone

IEnumWorkItems::Reset

IEnumWorkItems::Skip