Función lineProxyMessage (tapi.h)
Un controlador de solicitudes de proxy registrado usa la función lineProxyMessage para generar mensajes TAPI relacionados con su rol. Por ejemplo, un controlador de agente de ACD puede usar esta función para generar LINE_AGENTSTATUS mensajes recibidos por todas las aplicaciones que tengan abierta la línea especificada. TAPI suprime la generación del mensaje en el hLine especificado en los parámetros de función.
Sintaxis
LONG lineProxyMessage(
HLINE hLine,
HCALL hCall,
DWORD dwMsg,
DWORD dwParam1,
DWORD dwParam2,
DWORD dwParam3
);
Parámetros
hLine
Controle el dispositivo de línea abierta. TapI convierte esto en el hLine correcto para cada aplicación que recibe el mensaje.
hCall
Si el mensaje está relacionado con una llamada específica (que no es, en el caso de LINE_AGENTSTATUS), especifica el identificador del controlador de proxy para esa llamada; se establecerá en NULL para los mensajes que no estén relacionados con una llamada específica. TapI convierte esto en la hCall correcta para cada aplicación que recibe el mensaje.
dwMsg
Mensaje TAPI que se va a generar. Debe ser un mensaje que los controladores de proxy pueden generar.
dwParam1
Parámetro asociado al mensaje que se va a enviar.
dwParam2
Parámetro asociado al mensaje que se va a enviar.
dwParam3
Parámetro asociado al mensaje que se va a enviar.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o uno de estos valores de error negativos:
LINEERR_INVALLINEHANDLE, LINEERR_INVALCALLHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_NOTREGISTERED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |