Метод IEnumTASK::Next (mmc.h)
Метод IEnumTASK::Next позволяет MMC получить следующую задачу в списке задач оснастки.
Синтаксис
HRESULT Next(
[in] ULONG celt,
[out] MMC_TASK *rgelt,
[out] ULONG *pceltFetched
);
Параметры
[in] celt
Значение типа , указывающее количество предоставляемых задач. MMC всегда перечисляет задачи по одной за раз; поэтому кельт всегда равен 1.
[out] rgelt
Указатель на структуру MMC_TASK , заполняемую оснасткой для представления задачи, добавляемой на панель задач. Имейте в виду, что вызывающий объект (MMC) выделяет память для структуры.
[out] pceltFetched
Указатель на значение, указывающее количество возвращаемых задач. Если оснастка успешно вернула одну или несколько задач, задайте значение количества успешно возвращенных задач. Так как MMC всегда запрашивает одну задачу за раз (celt всегда равно 1), для pceltFetched следует задать значение 1, если задача была успешно возвращена. Если в списке оснастки больше нет задач или оснастки не удается заполнить структуру MMC_TASK, задайте для параметра значение 0.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
MMC вызывает этот метод для перечисления списка задач, которые оснастка должна добавить на панель задач. MMC вызывает этот метод, пока он не вернет S_FALSE, чтобы указать, что для оснастки больше нет задач, добавляемых на панель задач.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |