Funzione linePrepareAddToConference (tapi.h)

Articolo
03/08/2023

La funzione linePrepareAddToConference prepara una conferenza telefonica esistente per l'aggiunta di un'altra parte.

Sintassi

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

Parametri

hConfCall

Gestire una conferenza telefonica. L'applicazione deve essere un proprietario di questa chiamata. Lo stato della chiamata di hConfCall deve essere connesso.

lphConsultCall

Puntatore a un handle HCALL. Questa posizione viene quindi caricata con un handle che identifica la chiamata di consultazione da aggiungere. Inizialmente, l'applicazione è l'unico proprietario di questa chiamata.

lpCallParams

Puntatore a una struttura LINECALLPARAMS contenente parametri di chiamata da utilizzare per stabilire la chiamata di consultazione. Questo parametro può essere impostato su NULL se non sono desiderati parametri speciali di installazione delle chiamate.

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_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.

Commenti

Se viene restituito LINEERR_INVALLINESTATE, la riga non è attualmente in uno stato in cui è possibile eseguire questa operazione. Un elenco delle operazioni attualmente valide è disponibile nel membro dwLineFeatures (del tipo LINEFEATURE) nella struttura LINEDEVSTATUS . La chiamata a lineGetLineDevStatus aggiorna le informazioni in LINEDEVSTATUS.

Un handle di conferenza telefonica può essere ottenuto con lineSetupConference o con lineCompleteTransfer risolto come conferenza telefonica a tre vie. La funzione linePrepareAddToConference in genere inserisce la chiamata di conferenza esistente nello stato onHoldPendingConference e crea una chiamata di consultazione che può essere aggiunta successivamente alla chiamata di conferenza esistente con lineAddToConference.

La chiamata di consultazione può essere annullata utilizzando lineDrop. Può anche essere possibile che un'applicazione si scambi tra la chiamata di consultazione e la conferenza telefonica tenuta con lineSwapHold.