Метод ITPhone::get_PreferredAddresses (tapi3if.h)

Статья
03/02/2024

Метод get_PreferredAddresses возвращает коллекцию адресов, на которые предпочтительнее использовать телефон. Приложению не нужно вызывать ITPhone::Open перед выполнением этого метода.

Этот метод предназначен для Приложений Visual Basic и сценариев. Приложениям C/C++ удобнее использовать метод EnumerateAddresses .

Синтаксис

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

Параметры

[out] pAddresses

Указатель на VARIANT , содержащий itCollection указателей интерфейса ITAddress .

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

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

Значение	Значение
S_OK	Метод успешно выполнен.
E_POINTER	Параметр pAddresses не является допустимым указателем.
E_OUTOFMEMORY	Недостаточно памяти для выделения объекта коллекции.

Телефонное устройство объявляет себя предпочтительным для адреса или набора адресов, возвращая идентификаторы адреса или строки с помощью функции PHONEGetID TAPI 2.x с классом устройства tapi/line.

Хотя для функции phoneGetID требуется дескриптор для открытого телефонного устройства, приложению не нужно вызывать метод ITPhone::Open перед вызовом EnumeratePreferredAddresses. Это связано с тем, что реализация объекта phone может открывать телефон и вызывать phoneGetID во время инициализации TAPI или при появлении нового объекта phone.

TAPI вызывает метод AddRef в интерфейсе ITAddress , возвращаемом ITPhone::get_PreferredAddresses. Приложение должно вызвать Release в интерфейсе ITAddress , чтобы освободить связанные с ним ресурсы.