función TSPI_lineRemoveFromConference (tspi.h)

Artículo
08/26/2023

La función TSPI_lineRemoveFromConference quita la llamada especificada de la llamada de conferencia a la que pertenece actualmente. Las llamadas restantes en la llamada de conferencia no se ven afectadas.

Sintaxis

LONG TSPIAPI TSPI_lineRemoveFromConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdCall

Identificador de la llamada que se va a quitar de la conferencia. El estado de llamada de hdCall se puede conferenciar.

Valor devuelto

Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentarios

Esta operación quita una entidad que pertenece actualmente a una llamada de conferencia. Una vez que la llamada se haya quitado correctamente, puede ser posible manipularla aún más mediante su identificador. Es probable que la disponibilidad de esta operación y su resultado estén limitados en muchas implementaciones. Por ejemplo, en muchas implementaciones, solo se puede quitar la parte agregada más recientemente de una conferencia y la llamada eliminada se puede quitar automáticamente (se vuelve inactiva). El proveedor de servicios indica sus funcionalidades en LINEDEVCAPS con respecto a los efectos disponibles de quitar una llamada de una conferencia.

Si se admite la eliminación de un participante de una conferencia, el proveedor de servicios debe indicar en el miembro dwRemoveFromConfState en LINEADDRESSCAPS el estado de llamada al que se realiza la transición de la llamada después de quitarla de la conferencia.