Función lineAgentSpecific (tapi.h)

Artículo
03/08/2023

La función lineAgentSpecific permite que la aplicación acceda a funciones específicas del controlador propietario del controlador del agente asociado a la dirección. El significado de las extensiones es específico del controlador del agente. Cada conjunto de extensiones relacionadas con agente se identifica mediante un identificador de extensión de 128 bits único universal que se debe obtener, junto con la especificación de la extensión, del promulgador de esa extensión (normalmente el autor del software de controlador de agente en el servidor de telefonía). La lista de extensiones admitidas por el controlador de agente se obtiene de la estructura LINEAGENTCAPS devuelta por lineGetAgentCaps.

Sintaxis

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

dwAddressID

Dirección en el dispositivo de línea abierta. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

dwAgentExtensionIDIndex

Posición en la estructura ExtensionIDList en LINEAGENTCAPS de la extensión del controlador de agente que se está invocando.

lpParams

Puntero a un área de memoria utilizada para contener un bloque de parámetros. El formato de este bloque de parámetros es específico del dispositivo y tapi pasa su contenido a y desde la aplicación de controlador de agente en el servidor de telefonía. Este bloque de parámetros debe especificar la función que se va a invocar e incluir espacio suficiente para que se devuelvan los datos.

dwSize

Tamaño del área de bloque de parámetros, en bytes.

Nota Si lpParams es un puntero a una cadena, el tamaño debe incluir el terminador NULL .

Valor devuelto

Devuelve un identificador de solicitud positivo si se inicia la operación asincrónica; de lo contrario, esta función devuelve uno de estos valores de error negativos:

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Los valores devueltos adicionales son específicos del controlador del agente.

Comentarios

Esta operación forma parte de los servicios de telefonía extendida. Proporciona acceso a una característica específica del controlador de agente sin definir su significado.

Esta función proporciona un perfil de parámetro genérico. La interpretación de la estructura de parámetros es específica del controlador. Las indicaciones y respuestas enviadas de vuelta a la aplicación que son específicas del controlador deben usar el mensaje LINE_AGENTSPECIFIC .

Un controlador de agente puede proporcionar acceso a funciones específicas del controlador mediante la definición de parámetros para su uso con esta función. Las aplicaciones que quieran usar estas extensiones deben consultar la documentación específica del proveedor que describe qué extensiones se definen. Normalmente, una aplicación que se basa en estas extensiones no puede trabajar con otros entornos de controlador de agente.