ITPhone::get_PreferredAddresses 方法 (tapi3if.h)
get_PreferredAddresses 方法返回手机首选使用的地址集合。 执行此方法之前,应用程序不必调用 ITPhone::Open 。
此方法适用于 Visual Basic 和脚本应用程序。 C/C++ 应用程序会发现使用 EnumerateAddresses 方法更方便。
语法
HRESULT get_PreferredAddresses(
[out] VARIANT *pAddresses
);
参数
[out] pAddresses
指向包含 ITAddress 接口指针的 ITCollection 的 VARIANT 的指针。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
pAddresses 参数不是有效的指针。 |
|
没有足够的内存来分配集合对象。 |
注解
如果系统上没有可用地址,此方法将返回空集合。
电话设备通过使用 TAPI 2.x phoneGetID 函数和设备类 tapi/line 返回地址/线路 ID,将自己声明为地址或地址集的首选。
尽管 phoneGetID 函数需要打开的电话设备的句柄,但应用程序在调用 EnumeratePreferredAddresses 之前不必调用 ITPhone::Open 方法。 这是因为电话对象的实现可以在 TAPI 初始化期间或出现新的电话对象时打开电话并调用 phoneGetID 。
TAPI 在 ITPhone::get_PreferredAddresses 返回的 ITAddress 接口上调用 AddRef 方法。 应用程序必须在 ITAddress 接口上调用 Release 以释放与之关联的资源。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi3if.h (包括 Tapi3.h) |
Library | Uuid.lib |
DLL | Tapi3.dll |