调用句柄

会话标识符 概述中所述,调用句柄是 TAPI 2.2 应用程序标识特定通信会话的方式。 当应用程序启动会话时,TAPI 将返回一个调用句柄,供后续操作或查询使用。 当应用程序收到传入会话的通知时,TAPI 还会传入呼叫句柄。

会话结束且会话状态处于空闲状态后,调用句柄将保持有效,直到应用程序解除分配句柄或关闭该行。 该行可能被应用程序关闭,或者它可能会收到 LINE_CLOSE 消息。 如果某个行已关闭,则对该行上的调用的所有调用句柄将立即变为无效。

调用恢复到 空闲 状态后,仍允许应用程序读取调用的信息结构和状态。 这使应用程序能够使用 lineGetCallInfo 等操作检索调用信息以进行日志记录。

当应用程序没有进一步用于空闲调用的句柄时,它必须调用 lineDeallocateCall 以释放与调用相关的系统分配的内存。 TAPI 为具有调用句柄的每个应用程序分配每次调用的内存。 服务提供商可能还会分配内存来保存调用信息。 应用程序的调用句柄的解除分配允许库和服务提供商回收这些内存资源。 成功解除分配后,应用程序对调用的句柄将变为无效。

应用程序本身必须释放与其分配的调用相关的内存,该调用用于其自身目的。