lineGetCallStatus 函数 (tapi.h)

项目
08/26/2023

lineGetCallStatus 函数返回指定调用的当前状态。

语法

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

参数

hCall

要查询的调用的句柄。 hCall 的调用状态可以是任何状态。

lpCallStatus

指向 LINECALLSTATUS 类型的可变大小数据结构的指针。成功完成请求后，此结构将填充调用状态信息。在调用 lineGetCallStatus 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

注意如果结构中的 size 参数不正确，则有可能覆盖数据。有关设置结构大小的详细信息，请参阅内存分配主题。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_INVALCALLHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL。

注解

lineGetCallStatus 函数返回调用的动态状态，而 lineGetCallInfo 主要返回有关调用的静态信息。调用状态信息包括当前调用状态、在此状态下与调用相关的详细模式信息 (是否有任何) ，以及应用程序在调用处于此状态时可在调用时调用的可用 API 函数列表。应用程序在收到有关LINE_CALLSTATE消息的呼叫状态更改通知时，通常会对请求此信息感兴趣。