ITPhone：：EnumeratePreferredAddresses 方法 (tapi3if.h)

项目
03/02/2024

EnumeratePreferredAddresses 方法枚举电话对象的首选地址。执行此方法之前，应用程序不必调用 ITPhone：：Open 。

此方法适用于 C/C++ 应用程序。 Visual Basic 和脚本应用程序必须使用 get_Addresses 方法。

语法

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

参数

[out] ppEnumAddress

指向某个位置的指针，在成功时，方法将指针指向包含地址列表的枚举对象。有关更多信息，请参见下面的“备注”部分。

返回值

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

值	含义
S_OK	方法成功。
E_POINTER	ppEnumAddress 参数不是有效的指针。
E_OUTOFMEMORY	没有足够的内存来分配枚举对象。

注解

如果系统上没有可用地址，此方法将生成空枚举并返回S_OK。

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

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

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