Función lineCreateAgentSessionA (tapi.h)

La función lineCreateAgentSession crea un nuevo objeto AgentSession. Genera un mensaje de LINE_PROXYREQUEST que se va a enviar a un controlador de funciones de proxy registrado, haciendo referencia a una estructura LINEPROXYREQUEST de tipo LINEPROXYREQUEST_CREATEAGENTSESSION.

Sintaxis

LONG lineCreateAgentSessionA(
  HLINE           hLine,
  HAGENT          hAgent,
  LPCSTR          lpszAgentPIN,
  DWORD           dwWorkingAddressID,
  LPGUID          lpGroupID,
  LPHAGENTSESSION lphAgentSession
);

Parámetros

hLine

Controle el dispositivo de línea.

hAgent

Identificador del agente para el que se va a crear la sesión.

lpszAgentPIN

Puntero a un nullcadena Unicode terminada que contiene el PIN del agente o la contraseña. Se usa al trabajar con sistemas de ACD heredados que requieren un PIN independiente para cada sesión creada (o grupo en el que se ha iniciado sesión). Con un sistema ACD que usa el inicio de sesión de usuario del sistema operativo para la autenticación, lpszAgentPIN se establece en NULL.

dwWorkingAddressID

Identificador de la dirección en la que el agente recibirá llamadas para esta sesión.

lpGroupID

Puntero a un GUID que identifica el grupo para el que se va a crear la sesión.

lphAgentSession

Identificador de la sesión del agente creada, devuelta por el proxy de ACD. Es responsabilidad de la aplicación proxy del controlador de agente generar y mantener la unicidad de estos identificadores.

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.

Observaciones

Nota

El encabezado tapi.h define lineCreateAgentSession 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	tapi.h
biblioteca de	Tapi32.lib
DLL de	Tapi32.dll

Consulte también

Acerca de los controles del centro de llamadas

LINEPROXYREQUEST

LINE_PROXYREQUEST