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

Метод IEnumQueue::Next (tapi3.h)

  • Статья

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

Синтаксис

HRESULT Next(
  [in]  ULONG   celt,
  [out] ITQueue **ppElements,
  [out] ULONG   *pceltFetched
);

Параметры

[in] celt

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

[out] ppElements

Указатель на список возвращенных указателей интерфейса ITQueue .

[out] pceltFetched

Указатель на количество фактически предоставленных элементов. Может иметь значение NULL, если celt имеет одно значение.

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

Этот метод может возвращать одно из этих значений.

Значение Значение
S_OK
 Метод вернул число элементов celt .
S_FALSE
 Число оставшихся элементов было меньше celt.
E_POINTER
 Параметр ppElements не является допустимым указателем.
E_OUTOFMEMORY
 Для выполнения операции недостаточно памяти.

Комментарии

TAPI вызывает метод AddRef в интерфейсе ITQueue, возвращенном методом IEnumQueue::Next. Приложение должно вызвать Release в интерфейсе ITQueue , чтобы освободить связанные с ним ресурсы.

Требования

Требование Значение
Целевая платформа Windows
Header tapi3.h (включая Tapi3.h)
Библиотека Uuid.lib
DLL Tapi3.dll

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

ITQueue