LINE_PROXYREQUEST訊息

TAPI LINE_PROXYREQUEST 訊息會將要求傳遞給已註冊的 Proxy 函式處理常式。

參數

hDevice

應用程式對代理程式狀態已變更之線路裝置的控制碼。

dwCallbackInstance

開啟呼叫行時提供的回呼實例。

dwParam1

LINEPROXYREQUEST結構的指標，其中包含 Proxy 處理常式應用程式所要處理的要求。

dwParam2

保留的。

dwParam3

保留的。

傳回值

沒有傳回值。

備註

LINE_PROXYREQUEST訊息只會傳送至註冊以處理所傳遞類型 Proxy 要求的第一個應用程式。

應用程式應該處理 Proxy 緩衝區中包含的要求，並呼叫 lineProxyResponse 以傳回資料或傳遞結果。 只有在可以立即執行要求時，才能在應用程式 TAPI 回呼函式的內容中完成要求處理，而不需要等待任何其他實體的回應。 例如，如果應用程式需要與其他實體通訊 (，服務提供者來處理 PBX 型 ACD 或任何其他可能導致封鎖) 的系統服務，則要求應該排入應用程式內，並結束回呼函式，以避免延遲應用程式進一步的 TAPI 訊息接收。

在 將LINE_PROXYREQUEST 傳遞至 Proxy 處理常式時，TAPI 已將正 dwRequestID 函式結果傳回給原始應用程式，並解除封鎖呼叫執行緒以繼續執行。 應用程式正在等候 LINE_REPLY 訊息，此訊息會在 Proxy 處理常式應用程式呼叫 lineProxyResponse時自動產生。

應用程式不得釋放 lpProxyRequest所指向的記憶體。 TAPI 會在 lineProxyResponse執行期間釋放記憶體。 應用程式可以針對每個LINE_PROXYREQUEST訊息呼叫lineProxyResponse一次。

如果應用程式在有擱置 Proxy 要求時收到 LINE_CLOSE 訊息，則應該針對每個擱置的要求呼叫 lineProxyResponse ，並傳入適當的 dwResult 值 (，例如LINEERR_OPERATIONFAILED) 。

規格需求

需求	值
TAPI 版本	需要 TAPI 2.0 或更新版本
標頭	Tapi.h

另請參閱

LINE_CLOSE

LINE_REPLY

LINEPROXYREQUEST

lineProxyResponse