lineAgentSpecific 函数 (tapi.h)

项目
03/02/2024

lineAgentSpecific 函数允许应用程序访问与地址关联的代理处理程序的专用处理程序特定函数。扩展的含义特定于代理处理程序。每组与代理相关的扩展由一个通用唯一的 128 位扩展 ID 标识，该 ID 必须从该扩展的颁布者 (通常是电话服务器上代理处理程序软件的作者) 获取该扩展的规范。代理处理程序支持的扩展列表是从 lineGetAgentCaps 返回的 LINEAGENTCAPS 结构中获取的。

语法

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

参数

hLine

开行设备的句柄。

dwAddressID

开行设备上的地址。地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

dwAgentExtensionIDIndex

正在调用的代理处理程序扩展的 LINEAGENTCAPS 中 ExtensionIDList 结构中的位置。

lpParams

指向用于保存参数块的内存区域的指针。此参数块的格式特定于设备，其内容由 TAPI 传递到电话服务器上的代理处理程序应用程序或从中传递。此参数块必须指定要调用的函数，并包含足够的空间来返回任何数据。

dwSize

参数块区域的大小（以字节为单位）。

注意如果 lpParams 是指向字符串的指针，则大小必须包含 NULL 终止符。

返回值

如果异步操作开始，则返回正请求标识符;否则，此函数返回以下负错误值之一：

LINEERR_INVALADDRESSID、LINEERR_INVALAGENTID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_UNINITIALIZED。

其他返回值特定于代理处理程序。