lineSendUserUserInfo 函数 (tapi.h)

项目
08/26/2023

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

语法

LONG lineSendUserUserInfo(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

参数

hCall

用于发送用户-用户信息的调用的句柄。应用程序必须是呼叫的所有者。 hCall 的呼叫状态必须是连接、提供、已接受或回拨。

lpsUserUserInfo

指向包含要发送到远程方的用户信息字符串的指针。仅当基础网络支持时，才会发送用户-用户信息， (请参阅 LINEDEVCAPS) 。如果需要，用户-用户信息的协议鉴别器字段应显示为 lpsUserUserInfo 指向的缓冲区的第一个字节，并且必须在 dwSize 中考虑。

dwSize

lpsUserUserInfo 中用户信息的大小（以字节为单位）。

返回值

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG、LINEERR_NOTOWNER、LINEERR_UNINITIALIZED。

注解

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

用户信息还可以作为呼叫接受、呼叫拒绝和呼叫重定向的一部分以及呼叫时发送。也可以接收用户信息。接收的信息可通过呼叫的呼叫信息记录获得。每当用户信息在呼叫服务后或呼叫断开连接之前到达时，带有 UserUserInfo 参数的LINE_CALLINFO消息会通知应用程序呼叫信息记录中的用户信息已更改。如果链接了多个网络消息，则服务提供程序将收集信息，并将单个消息发送到应用程序。

此函数可能以未加密的形式通过网络发送数据;因此，在网络上窃听的人可能能够读取数据。在使用此方法之前，应考虑以明文形式发送数据的安全风险。