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