Метод ITPhone::EnumerateAddresses (tapi3if.h)
Метод EnumerateAddresses перечисляет адреса, по которым можно использовать телефон. Приложению не нужно вызывать ITPhone::Open перед выполнением этого метода.
Этот метод предназначен для приложений C/C++. Visual Basic и приложения сценариев должны использовать метод get_Addresses .
Синтаксис
HRESULT EnumerateAddresses(
[out] IEnumAddress **ppEnumAddress
);
Параметры
[out] ppEnumAddress
Указатель на интерфейс IEnumAddress .
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Если нет телефонов, доступных для использования с адресом, этот метод создает пустое перечисление и возвращает S_OK.
Телефонное устройство объявляет себя доступным на всех адресах, поддерживающих звуковые терминалы, с помощью TSP, задающего бит PHONEFEATURE_GENERICPHONE в элементе dwPhoneFeatures структуры PHONECAPS . Телефонное устройство также может объявить себя предпочтительным по сравнению с адресом или набором адресов, возвращая идентификаторы адресов или строк с помощью phoneGetID с классом устройства tapi/line. Метод EnumerateAddresses возвращает адреса, которые были определены в обоих направлениях.
Чтобы получить только адреса, на которые предпочтителен телефон, можно вызвать метод EnumeratePreferredAddresses .
Телефонное устройство объявляет себя специфичным для адреса или набора адресов, возвращая идентификаторы адресов или строк с помощью phoneGetID с классом устройства tapi/line. Хотя для функции phoneGetID требуется дескриптор открытого телефонного устройства, приложению не нужно вызывать метод ITPhone::Open перед вызовом EnumerateAddresses. Это связано с тем, что реализация объекта phone может открывать телефон и вызывать phoneGetID во время инициализации TAPI или при появлении нового объекта телефона.
TAPI вызывает метод AddRef в интерфейсе IEnumAddress , возвращаемом ITPhone::EnumerateAddresses. Приложение должно вызывать Release в интерфейсе IEnumAddress , чтобы освободить связанные с ним ресурсы.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi3if.h (включая Tapi3.h) |
| Библиотека | Uuid.lib |
| DLL | Tapi3.dll |