LINE_PROXYREQUEST mensagem
A mensagem tapi LINE_PROXYREQUEST entrega uma solicitação a um manipulador de função proxy registrado.
Parâmetros
-
hDevice
-
O identificador do aplicativo para o dispositivo de linha no qual o agente status foi alterado.
-
dwCallbackInstance
-
A instância de retorno de chamada fornecida ao abrir a linha da chamada.
-
Dwparam1
-
Ponteiro para uma estrutura LINEPROXYREQUEST que contém a solicitação a ser processada pelo aplicativo de manipulador proxy.
-
Dwparam2
-
Reservado.
-
dwParam3
-
Reservado.
Valor retornado
Sem valor de retorno.
Comentários
A mensagem LINE_PROXYREQUEST é enviada apenas para o primeiro aplicativo registrado para lidar com solicitações de proxy do tipo que está sendo entregue.
O aplicativo deve processar a solicitação contida no buffer de proxy e chamar lineProxyResponse para retornar dados ou entregar resultados. O processamento da solicitação deve ser feito no contexto da função de retorno de chamada TAPI do aplicativo somente se ela puder ser executada imediatamente, sem aguardar a resposta de qualquer outra entidade. Se o aplicativo precisar se comunicar com outras entidades (por exemplo, um provedor de serviços para manipular o ACD baseado em PBX ou qualquer outro serviço do sistema que possa resultar em bloqueio), a solicitação deverá ser enfileirada dentro do aplicativo e a função de retorno de chamada foi encerrada para evitar atrasar o recebimento de outras mensagens TAPI pelo aplicativo.
No momento em que o LINE_PROXYREQUEST é entregue ao manipulador de proxy, TAPI já retornou um resultado positivo da função dwRequestID para o aplicativo original e desbloqueou o thread de chamada para continuar a execução. O aplicativo está aguardando uma mensagem LINE_REPLY , que é gerada automaticamente quando o aplicativo do manipulador proxy chama lineProxyResponse.
O aplicativo não deve liberar a memória apontada por lpProxyRequest. O TAPI libera a memória durante a execução de lineProxyResponse. O aplicativo pode chamar lineProxyResponse exatamente uma vez para cada mensagem LINE_PROXYREQUEST .
Se o aplicativo receber uma mensagem LINE_CLOSE enquanto tiver solicitações de proxy pendentes, ele deverá chamar lineProxyResponse para cada solicitação pendente, passando um valor dwResult apropriado (como LINEERR_OPERATIONFAILED).
Requisitos
| Requisito | Valor |
|---|---|
| Versão do TAPI |
Requer TAPI 2.0 ou posterior |
| Cabeçalho |
|