Поделиться через


Метод IEnumWorkItems::Next (mstask.h)

[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]

Извлекает следующее указанное число задач в последовательности перечисления.

Если в последовательности осталось меньше запрошенного числа задач, извлекаются все остальные элементы.

Синтаксис

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

Параметры

[in] celt

Количество извлекаемых задач.

[out] rgpwszNames

Указатель на массив указателей (LPWSTR) на символьные строки, завершающиеся значением NULL, содержащие имена файлов задач, возвращаемых из последовательности перечисления. Эти имена файлов взяты из папки Запланированные задачи и имеют расширение ".job".

После обработки имен, возвращаемых в rgpwszNames, необходимо сначала освободить каждую строку символов в массиве, а затем сам массив с помощью CoTaskMemFree.

[out] pceltFetched

Указатель на количество задач, возвращаемых в rgpwszNames. Если параметр celt имеет значение 1, этот параметр может иметь значение NULL.

Возвращаемое значение

Возвращает одно из следующих значений.

Код возврата Описание
S_OK
Количество полученных задач равно запрошенным.
S_FALSE
Возвращаемое число меньше запрошенного числа. (Таким образом, больше нет задач для перечисления.)
E_INVALIDARG
Недопустимый параметр.
E_OUTOFMEMORY
Недостаточно памяти.

Комментарии

Интерфейс IEnumWorkItems также предоставляет методы для сброса перечисления, пропуска задач и создания копии текущего состояния перечисления.

Примеры

Пример использования функции Далее для перечисления задач в папке "Запланированные задачи" см. в разделе Пример перечисления задач.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mstask.h
Библиотека Mstask.lib
DLL Mstask.dll
Распространяемые компоненты Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

См. также раздел

IEnumWorkItems

IEnumWorkItems::Clone

IEnumWorkItems::Reset

IEnumWorkItems::Skip