lineGetCallInfo 函数 (tapi.h)

项目
03/02/2024

lineGetCallInfo 函数使应用程序能够获取有关指定调用的固定信息。

语法

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

参数

hCall

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

lpCallInfo

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

返回值

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

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

注解

每个传入或传出呼叫都存在单独的 LINECALLINFO 结构。结构主要包含有关调用的固定信息。当应用程序收到 LINE_CALLSTATE消息的调用句柄时，或者每次收到 LINE_CALLINFO 消息通知时，应用程序通常有兴趣检查此信息，指出部分调用信息结构已更改。这些消息将调用的句柄作为参数提供。