TSPI_lineCompleteCall函数 (tspi.h)

项目
03/03/2024

TSPI_lineCompleteCall 函数用于指定如何完成无法正常连接的调用。网络或交换机可能无法完成呼叫，因为网络资源繁忙或远程工作站正忙或未接听。

语法

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

参数

dwRequestID

异步请求的标识符。

hdCall

请求完成的调用的服务提供商句柄。 hdCall 的呼叫状态可以是忙碌、回拨或继续。

lpdwCompletionID

指向服务提供程序在其中写入完成标识符的 DWORD 大小的内存位置的指针。这唯一标识包含 hdCall 的行上正在进行的完成请求。具体而言，完成标识符在请求完成或使用 TSPI_lineUncompleteCall 函数取消后变为无效。一旦完成标识符无效，服务提供商可以随意重复使用该标识符。

dwCompletionMode

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

dwMessageID

使用 LINECALLCOMPLMODE_MESSAGE 完成调用时要发送的消息。此标识符从少量预定义消息中选择消息。调用此函数时，TAPI 不会验证此参数。

返回值

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

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

注解

当网络或交换机接受请求时，此函数被视为已完成;不是以指定的方式完全完成请求时。当被调用的工作站或网络进入可以按请求完成呼叫的状态时，服务提供商必须发送呼叫状态等于提供的LINE_CALLSTATE消息。呼叫的 LINECALLINFO 记录将调用的原因列为 CALLCOMPLETION，并提供完成标识符。在任何给定时间都有可能有多个未完成的调用完成请求;最大数目取决于设备。完成标识符还用于引用每个单独的请求，以便可以通过调用 TSPI_lineUncompleteCall 取消请求。