itAddress2::EnumeratePreferredPhones 方法 (tapi3if.h)

EnumeratePreferredPhones 方法枚举此地址的首选电话对象。

此方法适用于 C/C++ 应用程序。 Visual Basic 和脚本应用程序必须使用 get_PreferredPhones 方法。

语法

HRESULT EnumeratePreferredPhones(
  [out] IEnumPhone **ppEnumPhone
);

参数

[out] ppEnumPhone

指向位置的指针,如果成功,此方法将放置指向包含返回的手机列表的枚举对象的指针。

返回值

此方法可以返回其中一个值。

含义
S_OK
方法成功。
E_POINTER
ppEnumPhone 参数不是有效的指针。
E_OUTOFMEMORY
内存不足,无法分配枚举对象。

注解

电话设备通过使用 phoneGetID 和设备类 tapi/line 返回地址/行 ID,将自身声明为首选地址或地址集。 如果没有可用于地址的电话,此方法将生成空枚举并返回S_OK。

TAPI 在 ITAddress2::EnumeratePreferredPhones 返回的 IEnumPhone 接口上调用 AddRef 方法。 应用程序必须在 IEnumPhone 接口上调用 Release,以释放与其关联的资源。

要求

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

另请参阅

IEnumPhone

ITAddress2