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

Метод ITCollection::get__NewEnum (tapi3if.h)

  • Статья

Метод get__NewEnum получает перечислитель для коллекции.

Синтаксис

HRESULT get__NewEnum(
  [out] IUnknown **ppNewEnum
);

Параметры

[out] ppNewEnum

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

Вызовите метод QueryInterface в возвращенном интерфейсе IUnknown , чтобы получить указатель на интерфейс перечисления IEnumVARIANT в коллекции. IEnumVARIANT предоставляет ряд методов, которые можно использовать для итерации коллекции.

Дополнительные сведения см. в разделе "Примечания".

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

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

Код возврата Описание
S_OK
 Метод успешно выполнен.
E_OUTOFMEMORY
 Для выполнения операции недостаточно памяти.

Комментарии

Каждый интерфейс TAPI 3, включающий метод, возвращающий коллекцию, также включает метод, возвращающий указатель на интерфейс перечислителя TAPI 3. При программировании на C/C++ может быть проще напрямую вызвать метод перечислителя коллекции, чтобы получить объект перечислителя, а не вызывать метод ITCollection::get__NewEnum . Например, метод ITTAPI::EnumerateAddresses возвращает указатель на интерфейс IEnumAddress . IEnumAddress предоставляет методы перечисления для объекта Address.

При программировании на Visual Basic не нужно вызывать этот метод для перечисления коллекции. Это связано с тем, что функции метода можно вызвать неявно с помощью For... Каждый... В... Следующий... Конструкции.

Требования

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

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

ITCollection