lineSetAppSpecific 函数 (tapi.h)

项目
03/02/2024

lineSetAppSpecific 函数使应用程序能够设置指定调用的呼叫信息记录的应用程序特定字段。

语法

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

参数

hCall

需要设置其特定于应用程序的字段的调用的句柄。应用程序必须是调用的所有者。 hCall 的调用状态可以是任何状态。

dwAppSpecific

调用的 LINECALLINFO 结构的 dwAppSpecific 成员的新内容。电话 API 不解释此值。

返回值

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

LINEERR_INVALCALLHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_NOTOWNER、LINEERR_OPERATIONUNAVAIL、LINEERR_OPERATIONFAILED。

注解

电话 API 或其任何服务提供商不会解释每个调用存在的 LINECALLINFO 数据结构中特定于应用程序的字段。其用法完全由应用程序定义。可以从 lineGetCallInfo 返回的 LINECALLINFO 记录中读取该字段。但是，必须使用 lineSetAppSpecific 设置字段，以便更改对其他应用程序可见。更改此字段时，将向具有调用句柄的所有其他应用程序发送LINE_CALLINFO消息，指示 dwAppSpecific 成员已更改。