ITPhone：：EnumerateTerminals 方法 (tapi3if.h)

EnumerateTerminals 方法检索与手机关联的终端的枚举。执行此方法之前，应用程序不必调用 ITPhone：：Open 。

语法

HRESULT EnumerateTerminals(
  [in]  ITAddress     *pAddress,
  [out] IEnumTerminal **ppEnumTerminal
);

[in] pAddress

[out] ppEnumTerminal

指向枚举终端的 IEnumTerminal 接口的指针。

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

如果没有与手机关联的终端，此方法将生成空枚举并返回S_OK。

尽管 phoneGetID 函数需要打开的电话设备的句柄，但应用程序在调用 EnumerateTerminals 之前不必调用 ITPhone：：Open 方法。这是因为电话对象的实现可以在 TAPI 初始化期间或出现新的电话对象时打开电话并调用 phoneGetID 。

TAPI 在 ITPhone：：EnumerateTerminals 返回的 IEnumTerminal 接口上调用 AddRef 方法。应用程序必须在 IEnumTerminal 接口上调用 Release，以释放与之关联的资源。