Función lineGetGroupListA (tapi.h)

La función lineGetGroupList devuelve una lista de grupos de ACD disponibles en el sistema ACD. Genera un mensaje de LINE_PROXYREQUEST que se va a enviar a un controlador de funciones de proxy registrado, haciendo referencia a una LINEPROXYREQUEST estructura de tipo LINEPROXYREQUEST_GETGROUPLIST.

Sintaxis

LONG lineGetGroupListA(
  HLINE                hLine,
  LPLINEAGENTGROUPLIST lpGroupList
);

Parámetros

hLine

Controle el dispositivo de línea.

lpGroupList

Puntero a una estructura de tamaño variable de tipo LINEAGENTGROUPLIST. Tras completar correctamente la solicitud, esta estructura se rellena con una lista de los grupos de ACD disponibles. Antes de llamar a la función lineGetGroupList, la aplicación debe establecer el dwTotalSize miembro 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 sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema 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.

Observaciones

Nota

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

LINEAGENTGROUPLIST

LINEPROXYREQUEST

LINE_PROXYREQUEST