ITPhone::get_Addresses 方法 (tapi3if.h)

get_Addresses 方法返回电话可用于的地址集合。 执行此方法之前,应用程序不必调用 ITPhone::Open

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

语法

HRESULT get_Addresses(
  [out] VARIANT *pAddresses
);

参数

[out] pAddresses

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

返回值

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

注解

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

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

应用程序无需在调用get_Addresses之前调用 ITPhone::Open 方法。 这是因为电话对象的实现可以在 TAPI 初始化期间或出现新的电话对象时打开电话并调用 phoneGetID

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

要求

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

另请参阅

ITPhone

get_PreferredAddresses