Función lineGetAgentActivityListA (tapi.h)

Artículo
08/26/2023

La función lineGetAgentActivityList obtiene las identidades de las actividades que la aplicación puede seleccionar mediante lineSetAgentActivity para indicar qué función está realizando realmente el agente en ese momento.

Sintaxis

LONG lineGetAgentActivityListA(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

dwAddressID

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

lpAgentActivityList

Puntero a una estructura de tamaño variable de tipo LINEAGENTACTIVITYLIST. Tras completar correctamente la solicitud, esta estructura se rellena con una lista de los códigos de actividad del agente que se pueden seleccionar mediante lineSetAgentActivity. Antes de llamar a lineGetAgentActivityList, 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_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALAGENTID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentarios

Nota

El encabezado tapi.h define lineGetAgentActivityList 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.