Метод 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