TSPI_lineSendUserUserInfo函数 (tspi.h)

项目
08/26/2023

TSPI_lineSendUserUserInfo 函数在指定调用时将用户-用户信息发送到远程方。

语法

LONG TSPIAPI TSPI_lineSendUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

参数

dwRequestID

异步请求的标识符。

hdCall

要发送用户-用户信息的调用的句柄。 hdCall 的呼叫状态可以是连接、提供、接受或回拨。

lpsUserUserInfo

指向以 null 结尾的 Unicode 字符串的指针，其中包含要发送到远程方的用户信息。仅当基础网络支持时，才会发送用户-用户信息， (请参阅 LINEDEVCAPS) 。

dwSize

lpsUserUserInfo 中用户信息的大小（以字节为单位），包括 null 终止符。

返回值

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG、LINEERR_OPERATIONUNAVAIL。

注解

此函数可用于在连接呼叫期间随时发送用户信息。如果要发送的指定信息的大小大于单个网络消息的大小， (如 ISDN) 中所示，则服务提供商负责使用“更多数据”) 将信息分解为链接网络消息序列 (。

用户信息还可以作为呼叫接受、呼叫拒绝、呼叫重定向和呼叫时的一部分发送。也可以接收用户信息。接收的信息报告在呼叫的 LINECALLINFO 结构中。每当用户信息在呼叫套餐后或呼叫断开连接之前到达时，带有 UserUserInfo 参数的LINE_CALLINFO消息会通知 TAPI 呼叫信息记录中的用户信息已更改。如果链接了多个网络消息，则信息由服务提供商进行汇编，并将一条消息发送到 TAPI。