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。
其他返回值特定于代理处理程序。
注解
此操作是扩展电话服务的一部分。 它提供对代理处理程序特定功能的访问权限，而无需定义其含义。
此函数提供泛型参数配置文件。 参数结构的解释是特定于处理程序的。 发回应用程序且特定于处理程序的指示和答复应使用 LINE_AGENTSPECIFIC 消息。
代理处理程序可以通过定义要用于此函数的参数来提供对特定于处理程序的函数的访问。 希望使用这些扩展的应用程序应查阅特定于供应商的文档，其中描述了定义了哪些扩展。 通常，依赖于这些扩展的应用程序不能与其他代理处理程序环境一起使用。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tapi.h |
| Library | Tapi32.lib |
| DLL | Tapi32.dll |