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.
| Código de retorno | Descrição |
|---|---|
|
O número de tarefas recuperadas é igual ao número solicitado. |
|
O número retornado é menor que o número solicitado. (Portanto, não há mais tarefas para enumerar.) |
|
Um parâmetro é inválido. |
|
Não existe memória suficiente. |
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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mstask.h |
| Biblioteca | Mstask.lib |
| DLL | Mstask.dll |
| Redistribuível | Internet Explorer 4.0 ou posterior no Windows NT 4.0 e Windows 95 |