lineAnswer 函数 (tapi.h)

项目
08/26/2023

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

语法

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

参数

hCall

要应答的呼叫的句柄。应用程序必须是此调用的所有者。 hCall 的调用状态必须是提供或接受。

lpsUserUserInfo

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

dwSize

lpsUserUserInfo 中用户信息的大小 (包括 null 终止符) （以字节为单位）如果 lpsUserUserInfo 为 NULL，则不会向调用方发送用户-用户信息，并忽略 dwSize。

返回值

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

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

注解

当新的呼叫到达时，将向对呼叫感兴趣的应用程序发送一条LINE_CALLSTATE 消息，以提供新的呼叫句柄，并通知应用程序有关呼叫的状态和对新呼叫 (的权限，例如监视器或所有者) 。具有呼叫所有者权限的应用程序可以使用 lineAnswer 接听此呼叫。成功应答呼叫后，呼叫通常会转换为连接状态。最初，只有一个应用程序获得传入呼叫的所有者权限。

在某些电话环境中， (如 ISDN) ，其中用户警报独立于呼叫套餐，应用程序可以选择在接听之前接受呼叫，或者拒绝或重定向产品/服务呼叫。

如果在另一个呼叫处于活动状态时 () 提供呼叫，则调用 lineAnswer 将连接到新呼叫。这对现有活动调用的影响取决于线路的设备功能。第一次呼叫可能不受影响，可以自动将其丢弃，也可以自动置于保留状态。相应的LINE_CALLSTATE消息报告有关两个调用的状态转换到应用程序。

在桥接的情况下，如果调用已连接，但处于LINECONNECTEDMODE_INACTIVE状态，则可以使用 lineAnswer 函数进行联接。

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