ITPhone：：get_PreferredAddresses 方法 (tapi3if.h)

get_PreferredAddresses 方法返回手机首选使用的地址集合。执行此方法之前，应用程序不必调用 ITPhone：：Open 。

此方法适用于 Visual Basic 和脚本应用程序。 C/C++ 应用程序会发现使用 EnumerateAddresses 方法更方便。

语法

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

[out] pAddresses

指向包含 ITAddress 接口指针的 ITCollection 的 VARIANT 的指针。

此方法可以返回其中一个值。

如果系统上没有可用地址，此方法将返回空集合。

电话设备通过使用 TAPI 2.x phoneGetID 函数和设备类 tapi/line 返回地址/线路 ID，将自己声明为地址或地址集的首选。

尽管 phoneGetID 函数需要打开的电话设备的句柄，但应用程序在调用 EnumeratePreferredAddresses 之前不必调用 ITPhone：：Open 方法。这是因为电话对象的实现可以在 TAPI 初始化期间或出现新的电话对象时打开电话并调用 phoneGetID 。

TAPI 在 ITPhone：：get_PreferredAddresses 返回的 ITAddress 接口上调用 AddRef 方法。应用程序必须在 ITAddress 接口上调用 Release 以释放与之关联的资源。