通过

ITAddress2：：get_Phones 方法 (tapi3if.h)

  • 项目

get_Phones 方法返回一个 VARIANT 指针，指向与可与此地址一起使用的电话设备对应的电话对象的 ITCollection。

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

语法

HRESULT get_Phones(
  [out] VARIANT *pPhones
);

参数

[out] pPhones

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

返回值

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

注解

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

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

要求

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

另请参阅

EnumeratePhones

ITAddress2