itPhone::get_Terminals 方法 (tapi3if.h)
get_Terminals 方法检索与手机关联的终端的集合。 执行此方法之前,应用程序不必调用 ITPhone::Open 。
语法
HRESULT get_Terminals(
[in] ITAddress *pAddress,
[out] VARIANT *pTerminals
);
参数
[in] pAddress
指向 ITAddress 接口的 指针。
[out] pTerminals
指向包含 ITTerminal 接口指针的 ITCollection 的 VARIANT 的指针。
返回值
如果该方法成功,则返回 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 |