Función lineRemoveFromConference (tapi.h)

Artículo
08/26/2023

La función 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 lineRemoveFromConference(
  HCALL hCall
);

Parámetros

hCall

Controle la llamada que se va a quitar de la conferencia. La aplicación debe ser propietaria de esta llamada. El estado de llamada de hCall debe estar en conferencia.

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_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Comentarios

Esta operación quita una entidad que pertenece actualmente a una llamada de conferencia. Una vez que la llamada se ha 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 entidad agregada más recientemente de una conferencia y la llamada eliminada se puede quitar automáticamente (se vuelve inactiva). Consulte las funcionalidades del dispositivo de la línea para determinar los efectos disponibles de quitar una llamada de una conferencia.

Si se admite la eliminación de un participante de una conferencia, la llamada al participante, después de quitarla de la conferencia, entra en el estado de llamada que aparece en el miembro dwRemoveFromConfState en LINEADDRESSCAPS.