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 |