lineReleaseUserUserInfo 函数 (tapi.h)

项目
08/26/2023

lineReleaseUserUserInfo 函数通知服务提供商应用程序已处理 LINECALLINFO 结构中包含的用户-用户信息，随后收到的用户-用户信息现在可以写入该结构。服务提供商发送 LINE_CALLINFO 消息，指示LINECALLINFOSTATE_USERUSERINFO何时有新信息可用。

语法

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

参数

hCall

调用的句柄。应用程序必须是调用的所有者。 hCall 的调用状态可以是任何状态。

返回值

如果异步完成函数，则返回正请求标识符;如果发生错误，则返回负错误号。如果函数成功，则相应LINE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。可能的返回值为：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_NOTOWNER、LINEERR_UNINITIALIZED、LINEERR_OPERATIONUNAVAIL。

注解

lineReleaseUserUserInfo 函数允许应用程序控制 ISDN 连接上传入的用户-用户信息的流。收到新的完整的用户-用户信息消息时，服务提供商使用指定LINECALLINFOSTATE_USERUSERINFO) ( LINE_CALLINFO消息通知应用程序。任意数量的应用程序都可以使用 lineGetCallInfo) 检查 (信息，但拥有调用的应用程序控制何时释放信息，以便可以报告后续信息。在调用 lineReleaseUserUserInfo 之前，服务提供商不会使用较新的信息覆盖 LINECALLINFO 中以前的用户-用户信息。服务提供商负责缓冲随后收到的用户-用户信息，直到拥有调用的应用程序释放以前的信息。