Функция ADsEnumerateNext (adshlp.h)

Функция ADsEnumerateNext перечисляет указанное количество элементов из текущей позиции курсора перечислителя. При успешном выполнении операции функция возвращает перечислимый набор элементов в массиве вариантов. Число возвращаемых элементов может быть меньше указанного числа.

Синтаксис

HRESULT ADsEnumerateNext(
  [in]  IEnumVARIANT *pEnumVariant,
  [in]  ULONG        cElements,
  [out] VARIANT      *pvar,
  [out] ULONG        *pcElementsFetched
);

Параметры

[in] pEnumVariant

Тип: IEnumVARIANT*

Указатель на интерфейс IEnumVARIANT в объекте перечислителя.

[in] cElements

Тип: ULONG

Количество запрошенных элементов.

[out] pvar

Тип: VARIANT*

Указатель на массив извлеченных элементов.

[out] pcElementsFetched

Тип: ULONG*

Фактическое количество извлеченных элементов, которое может быть меньше количества запрошенных элементов.

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

Тип: HRESULT

Этот метод поддерживает стандартные возвращаемые значения.

Дополнительные сведения о других возвращаемых значениях см. в разделе Коды ошибок ADSI.

Комментарии

Общий процесс перечисления объектов в контейнере включает в себя следующее:

Сначала создайте объект перечислителя в этом контейнере.

Во-вторых, получите указатель интерфейса IEnumVARIANT .

В-третьих, вызовите функцию ADsEnumerateNext , чтобы вернуть перечислимый набор элементов из объекта перечислителя.

В-четвертых, вызовите функцию ADSFreeEnumerator , чтобы освободить объект перечислителя.

Дополнительные сведения и пример кода см. в разделе ADsBuildEnumerator .

Требования

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

Коды ошибок ADSI

Функции ADSI

ADsBuildEnumerator

ADsFreeEnumerator

FreeADsMem

IEnumVARIANT