LINE_PROXYREQUEST消息

TAPI LINE_PROXYREQUEST 消息将请求传递到已注册的代理函数处理程序。

            

参数

hDevice

代理状态已更改的线路设备的应用程序的句柄。

dwCallbackInstance

打开调用的线路时提供的回调实例。

dwParam1

指向 LINEPROXYREQUEST 结构的指针,该结构包含代理处理程序应用程序要处理的请求。

dwParam2

保留。

dwParam3

保留。

返回值

没有返回值。

备注

LINE_PROXYREQUEST消息仅发送到注册以处理所传递类型的代理请求的第一个应用程序。

应用程序应处理代理缓冲区中包含的请求,并调用 lineProxyResponse 以返回数据或传递结果。 仅当请求可以立即执行且无需等待任何其他实体的响应时,才应在应用程序的 TAPI 回调函数的上下文中完成。 如果应用程序需要与其他实体通信,例如, (服务提供商处理基于 PBX 的 ACD 或任何其他可能导致阻止) 的系统服务,则请求应在应用程序中排队并退出回调函数,以避免应用程序延迟接收进一步 TAPI 消息。

将LINE_PROXYREQUEST 传递到代理处理程序时,TAPI 已向原始应用程序返回一个正的 dwRequestID 函数结果,并取消了调用线程的阻止以继续执行。 应用程序正在等待 LINE_REPLY 消息,该消息在代理处理程序应用程序调用 lineProxyResponse 时自动生成。

应用程序不应释放 lpProxyRequest 指向的内存。 TAPI 在执行 lineProxyResponse 期间释放内存。 应用程序可以为每个LINE_PROXYREQUEST消息调用 lineProxyResponse 一次。

如果应用程序在具有挂起的代理请求时收到 LINE_CLOSE 消息,则应为每个挂起的请求调用 lineProxyResponse ,并传入相应的 dwResult 值 (,例如LINEERR_OPERATIONFAILED) 。

要求

要求
TAPI 版本
需要 TAPI 2.0 或更高版本
标头
Tapi.h

另请参阅

LINE_CLOSE

LINE_REPLY

LINEPROXYREQUEST

lineProxyResponse