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

Consulte también

LINE_AGENTSTATUS

Funciones de servicio de línea complementarias

Información general de referencia de TAPI 2.2