TSPI_lineAccept 函数 (tspi.h)

项目
08/26/2023

TSPI_lineAccept 函数接受指定的提供调用。可以选择将指定的用户-用户信息发送到调用方。

语法

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

参数

dwRequestID

异步请求的标识符。

hdCall

要接受的调用的句柄。 hdCall 的呼叫状态可以提供。

lpsUserUserInfo

指向 以 null 结尾的 Unicode 字符串的指针，该字符串包含要作为呼叫接受的一部分发送到远程方的用户信息。如果未发送用户-用户信息，则此指针为 NULL 。仅当基础网络支持时，才会发送用户-用户信息， (请参阅 LINEDEVCAPS) 。

dwSize

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

返回值

如果函数以异步方式完成，则返回 dwRequestID ;如果发生错误，则返回错误号。如果函数成功，则相应ASYNC_COMPLETION的 lResult 参数为零;如果发生错误，则为错误号。可能的返回值如下所示：

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

注解

TSPI_lineAccept 函数用于电话环境 (如 ISDN) ，这些环境允许与传入呼叫关联的警报与呼叫的初始产品分开。当呼叫传入时，首先提供呼叫。在一段时间内，客户端应用程序可以选择使用TSPI_lineDrop拒绝呼叫、使用 TSPI_lineRedirect将呼叫重定向到另一个工作站、使用TSPI_lineAnswer应答呼叫或使用TSPI_lineAccept接受呼叫。成功接受呼叫后，在被叫设备和呼叫设备处开始发出警报，通常呼叫状态将转换为接受状态。如果应用程序必须调用 TSPI_lineAccept才能开始发出警报，则服务提供商必须在 LINEADDRESSCAPS 数据结构的 dwAddrCapFlags 成员中设置标志LINEADDRCAPFLAGS_ACCEPTTOALERT。

对于 TAPI，使用带有响铃指示的LINE_LINEDEVSTATE消息报告警报。

非 ISDN 服务提供商可能也支持TSPI_lineAccept。其他 TAPI 客户端可以使用呼叫状态转换为接受状态，以指示某些应用程序已声明对呼叫负责，并已向用户提供呼叫。

客户端应用程序可以选择在接受时发送用户信息。即使可以发送用户-用户信息，通常也不能保证网络会将此信息提供给呼叫方。客户端应用程序可以查阅线路的设备功能，以确定呼叫接受是否可用。