Funzione lineRemoveFromConference (tapi.h)

Articolo
03/08/2023

La funzione lineRemoveFromConference rimuove la chiamata specificata dalla conferenza telefonica a cui appartiene. Le chiamate rimanenti nella conferenza telefonica non sono interessate.

Sintassi

LONG lineRemoveFromConference(
  HCALL hCall
);

Parametri

hCall

Gestire la chiamata da rimuovere dalla conferenza. L'applicazione deve essere un proprietario di questa chiamata. Lo stato della chiamata di hCall deve essere conferenza.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di LINE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

Questa operazione rimuove una parte che attualmente appartiene a una conferenza telefonica. Dopo che la chiamata è stata rimossa correttamente, potrebbe essere possibile modificarla ulteriormente usando il relativo handle. È probabile che la disponibilità di questa operazione e il relativo risultato siano limitati in molte implementazioni. In molte implementazioni, ad esempio, solo la parte aggiunta più di recente può essere rimossa da una conferenza e la chiamata rimossa può essere eliminata automaticamente (diventa inattiva). Consultare le funzionalità del dispositivo della linea per determinare gli effetti disponibili della rimozione di una chiamata da una conferenza.

Se la rimozione di un partecipante da una conferenza è supportata, la chiamata del partecipante, dopo essere stata rimossa dalla conferenza, immette lo stato della chiamata elencato nel membro dwRemoveFromConfState in LINEADDRESSCAPS.