Метод ITTAPI::EnumerateAddresses (tapi3if.h)
Метод EnumerateAddresses перечисляет доступные в настоящее время адреса. Предоставляется для приложений C и C++. Клиентские приложения службы автоматизации, например написанные на Visual Basic, должны использовать метод get_Addresses .
Синтаксис
HRESULT EnumerateAddresses(
[out] IEnumAddress **ppEnumAddress
);
Параметры
[out] ppEnumAddress
Указатель на интерфейс IEnumAddress .
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Значение |
|---|---|
|
Метод успешно выполнен. |
|
Параметр ppEnumAddress не является допустимым указателем. |
|
Объект TAPI не инициализирован. |
|
Для выполнения операции недостаточно памяти. |
Комментарии
Приложение обычно использует это перечисление, чтобы проверка возможности каждого адреса и определить, какие из них полезны для текущих целей.
Если ожидаемый адрес не найден, это может означать, что соответствующий поставщик услуг не установлен или работает неправильно.
TAPI вызывает метод Addref в интерфейсе IEnumAddress , возвращаемом методом ITTAPI::EnumerateAddresses. Чтобы освободить связанные с ним ресурсы, приложение должно вызвать метод Release в интерфейсе IEnumAddress .
Если во время сеанса TAPI создается или удаляется адрес, приложение будет уведомлено через интерфейс ITTAPIEventNotification . Если адрес был создан, например путем установки Plug and Play устройстве, функция ITTAPIEventNotification::Event возвращает TE_ADDRESSCREATE член перечисления TAPIOBJECT_EVENT. Если адрес удален, ФУНКЦИЯ ITTAPIEventNotification::Event возвращает TE_ADDRESSREMOVE. Вызов EnumerateAddresses после этих событий будет отражать текущие адреса.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi3if.h (включая Tapi3.h) |
| Библиотека | Uuid.lib |
| DLL | Tapi3.dll |