TSPI_lineAnswer 函数 (tspi.h)

项目
03/13/2024

TSPI_lineAnswer函数应答指定的产品/服务调用。

语法

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

参数

dwRequestID

异步请求的标识符。

hdCall

要应答的调用的服务提供商句柄。 hdCall 的调用状态可以是提供或接受。

lpsUserUserInfo

指向以 null 结尾的字符串的指针，其中包含在接听呼叫时要发送到远程方的用户信息。如果此指针为 NULL，则表示不发送用户-用户信息。仅当基础网络 (支持时，才会发送用户-用户信息，如 LINEDEVCAPS) 所示。

dwSize

lpsUserUserInfo 中用户-用户信息的大小（以字节为单位）。如果 lpsUserUserInfo 为 NULL，则忽略 dwSize 。

返回值

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

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

注解

当新的呼叫到达时，服务提供商会向 TAPI 发送 LINE_NEWCALL 消息，以交换呼叫的句柄。服务提供商随后会发送一条LINE_CALLSTATE 消息，告知 TAPI 及其客户端应用程序呼叫的状态。客户端应用程序通常使用 TSPI_lineAnswer 应答调用。通常，在成功接听呼叫后，呼叫将转换为连接状态。

在某些电话环境中 (如 ISDN) 用户警报与呼叫产品分开，TAPI 及其客户端应用程序可以选择先接听电话，然后再接听电话，或者拒绝或重定向 产品/服务 呼叫。

如果在另一个呼叫已处于活动状态时提供呼叫，则通过调用 TSPI_lineAnswer来连接新呼叫。此对现有活动调用的影响取决于线路的设备功能。第一个呼叫可能不受影响，它可能会自动被丢弃，或者自动处于保持状态。相应的LINE_CALLSTATE消息用于报告有关这两个调用的状态转换到 TAPI。