itPhone::get_Terminals 方法 (tapi3if.h)

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

语法

HRESULT get_Terminals(
  [in]  ITAddress *pAddress,
  [out] VARIANT   *pTerminals
);

参数

[in] pAddress

指向 ITAddress 接口的 指针。

[out] pTerminals

指向包含 ITTerminal 接口指针的 ITCollectionVARIANT 的指针。

返回值

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

注解

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

在调用 get_Terminals 之前,应用程序不必调用 ITPhone::Open 方法。 这是因为电话对象的实现可以在 TAPI 初始化期间或在出现新的电话对象时打开电话并调用 phoneGetID

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

要求

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

另请参阅

ITAddress

ITCollection

ITPhone

ITTerminal