LINE_PROXYREQUEST 메시지
TAPI LINE_PROXYREQUEST 메시지는 등록된 프록시 함수 처리기에 요청을 전달합니다.
매개 변수
-
hDevice
-
에이전트 상태 변경된 라인 디바이스에 대한 애플리케이션의 핸들입니다.
-
dwCallbackInstance
-
콜백은 호출의 줄을 열 때 제공된 instance.
-
dwParam1
-
프록시 처리기 애플리케이션에서 처리할 요청을 포함하는 LINEPROXYREQUEST 구조체에 대한 포인터입니다.
-
dwParam2
-
예약되어 있습니다.
-
dwParam3
-
예약되어 있습니다.
반환 값
반환 값이 없습니다.
설명
LINE_PROXYREQUEST 메시지는 전달되는 형식의 프록시 요청을 처리하기 위해 등록된 첫 번째 애플리케이션으로만 전송됩니다.
애플리케이션은 프록시 버퍼에 포함된 요청을 처리하고 lineProxyResponse 를 호출하여 데이터를 반환하거나 결과를 제공해야 합니다. 요청 처리는 다른 엔터티의 응답을 기다리지 않고 즉시 수행할 수 있는 경우에만 애플리케이션의 TAPI 콜백 함수 컨텍스트 내에서 수행해야 합니다. 애플리케이션이 다른 엔터티(예: PBX 기반 ACD를 처리하는 서비스 공급자 또는 차단될 수 있는 다른 시스템 서비스)와 통신해야 하는 경우 애플리케이션 내에서 요청을 큐에 대기하고 애플리케이션에서 추가 TAPI 메시지 수신을 지연하지 않도록 콜백 함수를 종료해야 합니다.
LINE_PROXYREQUEST 프록시 처리기에 전달될 때 TAPI는 이미 양의 dwRequestID 함수 결과를 원래 애플리케이션에 반환하고 호출 스레드의 차단을 해제하여 실행을 계속합니다. 애플리케이션은 프록시 처리기 애플리케이션이 lineProxyResponse를 호출할 때 자동으로 생성되는 LINE_REPLY 메시지를 기다리고 있습니다.
애플리케이션은 lpProxyRequest가 가리키는 메모리를 해제하지 않습니다. TAPI는 lineProxyResponse를 실행하는 동안 메모리를 해제합니다. 애플리케이션은 각 LINE_PROXYREQUEST 메시지에 대해 lineProxyResponse를 정확히 한 번 호출할 수 있습니다.
보류 중인 프록시 요청이 있는 동안 애플리케이션이 LINE_CLOSE 메시지를 수신하는 경우 보류 중인 각 요청에 대해 lineProxyResponse 를 호출하여 적절한 dwResult 값(예: LINEERR_OPERATIONFAILED)을 전달해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| TAPI 버전 |
TAPI 2.0 이상이 필요합니다. |
| 헤더 |
|