función lineCreateAgentA (tapi.h)

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

Sintaxis

LONG lineCreateAgentA(
  HLINE    hLine,
  LPCSTR   lpszAgentID,
  LPCSTR   lpszAgentPIN,
  LPHAGENT lphAgent
);

Parámetros

hLine

Identificador del dispositivo de línea.

lpszAgentID

Puntero a una cadena Unicode terminada en null que contiene el identificador del agente. Se usa al trabajar con sistemas de ACD heredados. Con un sistema ACD que usa el inicio de sesión de usuario del sistema operativo para la autenticación, lpszAgentID se establece en NULL.

lpszAgentPIN

Puntero a una cadena Unicode terminada en null que contiene el PIN o la contraseña del agente. Se usa al trabajar con sistemas de ACD heredados. 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.

lphAgent

Identificador del agente creado, devuelto por el proxy de ACD. Es responsabilidad de la aplicación proxy del controlador de agente generar y mantener la unicidad de este identificador.

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.

Comentarios

Nota

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

Requisitos

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

Consulte también

LINEPROXYREQUEST

LINE_PROXYREQUEST