itAddress2：：get_PreferredPhones 方法 (tapi3if.h)

get_PreferredPhones 方法返回对应于首选用于此地址的电话设备的电话对象的集合。

此方法适用于 Visual Basic 和脚本应用程序。 C/C++ 应用程序应改用 EnumeratePreferredPhones 方法。

语法

HRESULT get_PreferredPhones(
  [out] VARIANT *pPhones
);

[out] pPhones

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

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

电话设备通过使用具有设备类 tapi/line 的 phoneGetID 返回地址/线路 ID，将自己声明为首选地址或地址集。如果没有电话可用于此地址，该方法将生成空集合并返回S_OK。

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