lineAccept 函数 (tapi.h)

项目
03/02/2024

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

语法

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

参数

hCall

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

lpsUserUserInfo

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

dwSize

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

返回值

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

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

注解

lineAccept 函数用于电话环境，如集成服务数字网络 (ISDN) ，允许与传入呼叫关联的警报与呼叫的初始产品分开。当呼叫传入时，它首先提供。在一些时间里，应用程序可以选择使用 lineDrop 拒绝呼叫、使用 lineRedirect 将呼叫重定向到另一个工作站、使用 lineAnswer 应答呼叫或使用 lineAccept 接受呼叫。应用程序成功接受呼叫后，警报从被调用设备和呼叫设备开始，呼叫状态通常转换为 “已接受”。

警报由带有响铃指示的LINE_LINEDEVSTATE消息报告给应用程序。

非 ISDN 服务提供商可能也支持 lineAccept 函数。呼叫状态转换为“已接受”可由其他应用程序用作指示另一个应用程序已声明对呼叫负责并已向用户提供呼叫。

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