lineCompleteCall 函数 (tapi.h)

项目
03/02/2024

lineCompleteCall 函数指定如何改为完成无法正常连接的调用。网络或交换机可能无法完成呼叫，因为网络资源繁忙或远程工作站正忙或未接听。应用程序可以通过多种方式之一请求完成调用。

语法

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

参数

hCall

请求完成的调用的句柄。应用程序必须是呼叫的所有者。 hCall 的调用状态必须为忙碌或回拨。

lpdwCompletionID

指向 DWORD 大小的内存位置的指针。完成标识符用于标识正在进行的单个完成请求。完成标识符变为无效，可以在请求完成或取消未完成的请求后重复使用。

dwCompletionMode

完成调用的方式。此参数只使用一个 LINECALLCOMPLMODE_常量。

dwMessageID

使用 LINECALLCOMPLMODE_MESSAGE 完成调用时要发送的消息。此标识符从少量预定义消息中选择消息。

返回值

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

LINEERR_COMPLETIONOVERRUN、LINEERR_NOMEM、LINEERR_INVALCALLCOMPLMODE、LINEERR_NOTOWNER、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALMESSAGEID、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED。

注解

当请求已被网络或交换机接受时，此函数被视为已完成;不是以指定方式完全完成请求时。此函数完成后，调用通常会转换为空闲。当被调用的工作站或网络进入可以按请求完成呼叫的状态时，应用程序将收到一条LINE_CALLSTATE 消息通知，其呼叫状态等于 产品/ 服务。呼叫的 LINECALLINFO 记录以 CALLCOMPLETION 的形式列出调用的原因，并提供完成标识符。可能有多个未完成的调用完成请求;最大数量取决于设备。完成标识符还用于引用每个请求，以便可以通过调用 lineUncompleteCall 取消请求。