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

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

  • Статья

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

Синтаксис

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

Параметры

[in] celt

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

[out] ppElements

Указатель на интерфейсы ITAgentHandler .

[out] pceltFetched

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

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

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

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

Комментарии

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

Требования

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

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

IEnumAgentHandler