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 或更高版本 |
标头 |
|