Función linePrepareAddToConference (tapi.h)

Artículo
03/02/2024

La función linePrepareAddToConference prepara una llamada de conferencia existente para la adición de otra entidad.

Sintaxis

LONG linePrepareAddToConference(
  HCALL                  hConfCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Parámetros

hConfCall

Controlar a una llamada de conferencia. La aplicación debe ser propietaria de esta llamada. El estado de llamada de hConfCall debe estar conectado.

lphConsultCall

Puntero a un controlador HCALL. A continuación, esta ubicación se carga con un identificador que identifica la llamada de consulta que se va a agregar. Inicialmente, la aplicación es el único propietario de esta llamada.

lpCallParams

Puntero a una estructura LINECALLPARAMS que contiene parámetros de llamada que se usarán al establecer la llamada de consulta. Este parámetro se puede establecer en NULL si no se desea ningún parámetro de configuración de llamada especial.

Valor devuelto

Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de LINE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_CALLUNAVAIL, LINEERR_INVALRATE, LINEERR_CONFERENCEFULL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALMEDIAMODE, LINEERR_UNINITIALIZED.

Comentarios

Si se devuelve LINEERR_INVALLINESTATE, la línea no se encuentra actualmente en un estado en el que se puede realizar esta operación. Puede encontrar una lista de operaciones válidas actualmente en el miembro dwLineFeatures (del tipo LINEFEATURE) en la estructura LINEDEVSTATUS . (Al llamar a lineGetLineDevStatus, se actualiza la información de LINEDEVSTATUS).

Se puede obtener un identificador de llamada de conferencia con lineSetupConference o con lineCompleteTransfer que se resuelve como una llamada de conferencia triple. La función linePrepareAddToConference suele colocar la llamada de conferencia existente en el estado onHoldPendingConference y crea una llamada de consulta que se puede agregar más adelante a la llamada de conferencia existente con lineAddToConference.

La llamada de consulta se puede cancelar mediante lineDrop. También puede ser posible que una solicitud intercambie entre la llamada de consulta y la llamada de conferencia celebrada con lineSwapHold.