itAddress2::EnumeratePreferredPhones 方法 (tapi3if.h)
EnumeratePreferredPhones 方法枚举此地址的首选电话对象。
此方法适用于 C/C++ 应用程序。 Visual Basic 和脚本应用程序必须使用 get_PreferredPhones 方法。
语法
HRESULT EnumeratePreferredPhones(
[out] IEnumPhone **ppEnumPhone
);
参数
[out] ppEnumPhone
指向位置的指针,如果成功,此方法将放置指向包含返回的手机列表的枚举对象的指针。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
ppEnumPhone 参数不是有效的指针。 |
|
内存不足,无法分配枚举对象。 |
注解
电话设备通过使用 phoneGetID 和设备类 tapi/line 返回地址/行 ID,将自身声明为首选地址或地址集。 如果没有可用于地址的电话,此方法将生成空枚举并返回S_OK。
TAPI 在 ITAddress2::EnumeratePreferredPhones 返回的 IEnumPhone 接口上调用 AddRef 方法。 应用程序必须在 IEnumPhone 接口上调用 Release,以释放与其关联的资源。
要求
目标平台 | Windows |
标头 | tapi3if.h (包括 Tapi3.h) |
Library | Uuid.lib |
DLL | Tapi3.dll |