Метод 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.
Возвращаемое значение
Возвращает одно из следующих значений.
Код возврата | Описание |
---|---|
|
Количество полученных задач равно запрошенным. |
|
Возвращаемое число меньше запрошенного числа. (Таким образом, больше нет задач для перечисления.) |
|
Недопустимый параметр. |
|
Недостаточно памяти. |
Комментарии
Интерфейс 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 |