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