Función lineGetAgentSessionInfo (tapi.h)

La función lineGetAgentSessionInfo devuelve una estructura que contiene la información de ACD asociada a un identificador de sesión de agente determinado. Genera un mensaje 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_GETAGENTSESSIONINFO.

Sintaxis

LONG lineGetAgentSessionInfo(
  HLINE                  hLine,
  HAGENTSESSION          hAgentSession,
  LPLINEAGENTSESSIONINFO lpAgentSessionInfo
);

Parámetros

hLine

Controle el dispositivo de línea.

hAgentSession

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

lpAgentSessionInfo

Puntero a una estructura de tipo LINEAGENTSESSIONINFO. Una vez completada correctamente la solicitud, esta estructura se rellena con las estadísticas de sesión del agente. Antes de llamar a la función lineGetAgentSessionInfo , 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.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

Acerca de los controles del centro de llamadas

LINEAGENTSESSIONINFO

LINEPROXYREQUEST

LINE_PROXYREQUEST