Función lineGetAgentSessionList (tapi.h)

Artículo
03/08/2023

La función lineGetAgentSessionList devuelve una lista de sesiones de agente creadas para el agente especificado. Genera un mensaje de LINE_PROXYREQUEST que se va a enviar a un controlador de función de proxy registrado, haciendo referencia a una estructura LINEPROXYREQUEST de tipo LINEPROXYREQUEST_GETAGENTSESSIONLIST.

Sintaxis

LONG lineGetAgentSessionList(
  HLINE                  hLine,
  HAGENT                 hAgent,
  LPLINEAGENTSESSIONLIST lpAgentSessionList
);

Parámetros

hLine

Controle el dispositivo de línea.

hAgent

Identificador del agente cuya información se va a recuperar.

lpAgentSessionList

Puntero a una estructura de tamaño variable de tipo LINEAGENTSESSIONLIST. Una vez completada correctamente la solicitud, esta estructura se rellena con una lista de las sesiones del agente que se han creado para este agente. Antes de llamar a la función lineGetAgentSessionList , la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriba la memoria. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .

Valor devuelto

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

LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.