ITPhone::EnumerateTerminals 方法 (tapi3if.h)

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

语法

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

参数

[in] pAddress

指向 ITAddress 接口的 指针。

[out] ppEnumTerminal

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

返回值

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

注解

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

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

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

要求

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

另请参阅

IEnumTerminal

ITAddress

ITPhone