TSPI_lineReleaseUserUserInfo函数 (tspi.h)

项目
08/26/2023

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

语法

LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

参数

dwRequestID

异步请求的标识符。

hdCall

要为其释放用户信息的服务提供程序对调用的句柄。 hdCall 的调用状态可以是任意。

返回值

如果发生错误，则返回 dwRequestID 或错误号。如果函数成功，相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。可能的返回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注解

TSPI_lineReleaseUserUserInfo 函数允许控制 ISDN 连接上传入的用户信息流。收到新的完整的用户信息消息时，服务提供商使用指定LINECALLINFOSTATE_USERUSERINFO) LINE_CALLINFO 消息 (通知 TAPI。 LINECALLINFO 中的用户信息和其他字段可以通过多次调用来检查TSPI_lineGetCallInfo。在调用TSPI_lineReleaseUserUserInfo之前，服务提供商不得使用较新的信息覆盖 LINECALLINFO 中以前的用户信息。服务提供程序必须缓冲随后收到的用户信息，直到释放以前的信息。调用 TSPI_lineCloseCall 时，可以丢弃任何剩余的缓冲信息。

如果在 LINECALLINFO 中没有用户信息时调用此函数，则服务提供商应返回成功指示。

为了向后兼容，如果针对不导出函数的服务提供商控制的某一行调用调用此函数，TAPI 会自动返回LINEERR_OPERATIONUNAVAIL。