Метод 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 также предоставляет методы для сброса перечисления, пропуска задач и создания копии текущего состояния перечисления.

Примеры

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

Требования

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

IEnumWorkItems

IEnumWorkItems::Clone

IEnumWorkItems::Reset

IEnumWorkItems::Skip