Función lineGetAgentCapsA (tapi.h)

Artículo
03/08/2023

La función lineGetAgentCaps obtiene las funcionalidades relacionadas con el agente admitidas en el dispositivo de línea especificado. Si se llama a un agente específico, las funcionalidades incluyen una lista de grupos de ACD en los que el agente puede iniciar sesión.

Sintaxis

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Parámetros

hLineApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

Dispositivo de línea que contiene la dirección que se va a consultar.

dwAddressID

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

dwAppAPIVersion

Versión de API más alta compatible con la aplicación. Este no debe ser el valor negociado mediante lineNegotiateAPIVersion en el dispositivo que se está consultando.

lpAgentCaps

Puntero a una estructura de tamaño variable de tipo LINEAGENTCAPS. Después de completar correctamente la solicitud, esta estructura se rellena con información sobre las funcionalidades del agente. Antes de llamar a lineGetAgentCaps, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

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_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Comentarios

Nota:

El encabezado tapi.h define lineGetAgentCaps como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.