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

Метод IEnumConnections::Next (ocidl.h)

  • Статья

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

Синтаксис

HRESULT Next(
  [in]  ULONG         cConnections,
  [out] LPCONNECTDATA rgcd,
  [out] ULONG         *pcFetched
);

Параметры

[in] cConnections

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

[out] rgcd

Массив перечисляемых элементов.

Перечислитель отвечает за выделение памяти, а вызывающий — за ее освобождение. Если значение celt больше 1, вызывающий объект также должен передать указатель, отличный от NULL, переданный в pceltFetched , чтобы узнать, сколько указателей необходимо освободить.

[out] pcFetched

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

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

Если метод извлекает количество запрошенных элементов, возвращаемое значение будет S_OK. В противном случае это S_FALSE.

Комментарии

После успешного возврата этого метода вызывающий объект отвечает за вызов Release (см. pUnk-элементCONNECTDATA) для каждого элемента в массиве. Если значение cConnections больше единицы, вызывающий объект также должен передать указатель, отличный от NULL, в lpcFetched , чтобы получить количество указателей, которые необходимо освободить.

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header ocidl.h (включая ObjIdl.h)

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

CONNECTDATA

IEnumConnections