ITPhone：：EnumerateAddresses 方法 (tapi3if.h)

EnumerateAddresses 方法枚举可以使用电话的地址。 执行此方法之前，应用程序不必调用 ITPhone：：Open 。

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

语法

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

参数

[out] ppEnumAddress

指向 IEnumAddress 接口的 指针。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

如果没有电话可用于地址，此方法将生成空枚举并返回S_OK。

电话设备通过 TSP 在 PHONECAPS 结构的 dwPhoneFeatures 成员中设置PHONEFEATURE_GENERICPHONE位来声明自己在所有支持音频终端的地址上可用。 电话设备还可以通过使用具有设备类 tapi/line 的 phoneGetID 返回地址/线路 ID，将自己声明为地址或地址集的首选地址或地址集。 EnumerateAddresses 方法返回已双向标识的地址。

若要仅获取首选电话的地址，可以调用 EnumeratePreferredAddresses 方法。

电话设备通过使用具有设备类 tapi/line 的 phoneGetID 返回地址/线路 ID，将自己声明为特定于一个地址或地址集。 尽管 phoneGetID 函数需要打开电话设备的句柄，但应用程序在调用 EnumerateAddresses 之前不必调用 ITPhone：：Open 方法。 这是因为电话对象的实现可以在 TAPI 初始化期间或出现新的电话对象时打开电话并调用 phoneGetID 。

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

要求

另请参阅

EnumeratePreferredAddresses

ITPhone