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

Статья
03/05/2024

Метод EnumeratePreferredAddresses перечисляет предпочтительные адреса для объекта phone. Приложению не нужно вызывать ITPhone::Open перед выполнением этого метода.

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

Синтаксис

HRESULT EnumeratePreferredAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Параметры

[out] ppEnumAddress

Указатель на расположение, где при успешном выполнении метод помещает указатель на объект перечисления, содержащий список адресов. Дополнительные сведения см. в разделе "Примечания".

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

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

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

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

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

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