funzione TSPI_lineRemoveFromConference (tspi.h)

Articolo
08/26/2023

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

Sintassi

LONG TSPIAPI TSPI_lineRemoveFromConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle della chiamata da rimuovere dalla conferenza. Lo stato della chiamata di hdCall può essere conferenza.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

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

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). Il provider di servizi indica le sue funzionalità in LINEDEVCAPS in relazione agli effetti disponibili della rimozione di una chiamata da una conferenza.

Se la rimozione di un partecipante da una conferenza è supportata, il provider di servizi deve indicare nel membro dwRemoveFromConfState in LINEADDRESSCAPS lo stato di chiamata a cui viene eseguita la transizione della chiamata dopo la rimozione dalla conferenza.