通过

itAddress2：：EnumeratePhones 方法 (tapi3if.h)

  • 项目

EnumeratePhones 方法枚举可与此地址一起使用的电话设备对应的电话对象。

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

语法

HRESULT EnumeratePhones(
  [out] IEnumPhone **ppEnumPhone
);

参数

[out] ppEnumPhone

指向新 IEnumPhone 接口的指针。

返回值

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

值 含义
S_OK
 方法成功。
E_POINTER
 ppEnumPhone 参数不是有效的指针。
E_OUTOFMEMORY
 内存不足，无法执行操作。
E_UNEXPECTED
 方法因未知原因而失败。

注解

电话设备通过 TSP 在 PHONECAPS 结构的 dwPhoneFeatures 成员中设置PHONEFEATURE_GENERICPHONE位，将自身声明为在所有支持音频终端的地址上可用。 电话设备还可以通过将 phoneGetID 与设备类 tapi/line 结合使用来返回地址/行 ID，将自身声明为首选地址或地址集。 如果没有可用于地址的电话，此方法将生成空枚举并返回S_OK。

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

要求

要求 值
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

IEnumPhone

ITAddress2