LINE_PROXYREQUEST mensaje

El mensaje LINE_PROXYREQUEST TAPI entrega una solicitud a un controlador de función de proxy registrado.

Parámetros

hDevice

Identificador de la aplicación en el dispositivo de línea en el que ha cambiado el estado del agente.

dwCallbackInstance

La instancia de devolución de llamada proporcionada al abrir la línea de la llamada.

dwParam1

Puntero a una estructura LINEPROXYREQUEST que contiene la solicitud que va a procesar la aplicación del controlador de proxy.

dwParam2

Reservado.

dwParam3

Reservado.

Valor devuelto

No de devuelve ningún valor.

Comentarios

El mensaje LINE_PROXYREQUEST solo se envía a la primera aplicación registrada para controlar las solicitudes de proxy del tipo que se entrega.

La aplicación debe procesar la solicitud contenida en el búfer de proxy y llamar a lineProxyResponse para devolver datos o entregar resultados. El procesamiento de la solicitud debe realizarse dentro del contexto de la función de devolución de llamada TAPI de la aplicación solo si se puede realizar inmediatamente, sin esperar la respuesta de cualquier otra entidad. Si la aplicación necesita comunicarse con otras entidades (por ejemplo, un proveedor de servicios para controlar ACD basado en PBX o cualquier otro servicio del sistema que pueda dar lugar a bloqueos), la solicitud se debe poner en cola dentro de la aplicación y la función de devolución de llamada salió para evitar retrasar la recepción de más mensajes TAPI por parte de la aplicación.

En el momento en que el LINE_PROXYREQUEST se entrega al controlador de proxy, TAPI ya ha devuelto un resultado positivo dwRequestID a la aplicación original y ha desbloqueado el subproceso que realiza la llamada para continuar la ejecución. La aplicación está esperando un mensaje de LINE_REPLY , que se genera automáticamente cuando la aplicación del controlador de proxy llama a lineProxyResponse.

La solicitud no liberará la memoria a la que apunta lpProxyRequest. TAPI libera la memoria durante la ejecución de lineProxyResponse. La aplicación puede llamar a lineProxyResponse exactamente una vez para cada mensaje LINE_PROXYREQUEST .

Si la aplicación recibe un mensaje de LINE_CLOSE mientras tiene solicitudes de proxy pendientes, debe llamar a lineProxyResponse para cada solicitud pendiente, pasando un valor dwResult adecuado (como LINEERR_OPERATIONFAILED).

Requisitos

Requisito	Value
Versión de TAPI	Requiere TAPI 2.0 o posterior
Encabezado	Tapi.h

Consulte también

LINE_CLOSE

LINE_REPLY

LINEPROXYREQUEST

lineProxyResponse