Funzione lineGetConfRelatedCalls (tapi.h)

Articolo
08/26/2023

La funzione lineGetConfRelatedCalls restituisce un elenco di handle di chiamata che fanno parte della stessa conferenza telefonica della chiamata specificata. La chiamata specificata è una conferenza telefonica o una chiamata di partecipante in una conferenza telefonica. Vengono generati nuovi handle per le chiamate per le quali l'applicazione non dispone già di handle e all'applicazione viene concesso il privilegio di monitoraggio a tali chiamate.

Sintassi

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

Parametri

hCall

Gestire una chiamata. Si tratta di una conferenza telefonica o di una chiamata di partecipante in una conferenza telefonica. Per una conferenza telefonica, lo stato della chiamata di hCall può essere qualsiasi stato. Per una chiamata di partecipante alla conferenza, deve trovarsi nello stato di conferenza .

lpCallList

Puntatore a una struttura di dati con dimensioni variabili di tipo LINECALLLIST. Al termine della richiesta, gli handle di chiamata a tutte le chiamate nella conferenza telefonica vengono restituiti in questa struttura. La prima chiamata nell'elenco è la conferenza telefonica, le altre chiamate sono le chiamate dei partecipanti. All'applicazione viene concesso il privilegio di monitoraggio per le chiamate per le quali non dispone già di handle; i privilegi da chiamare nell'elenco per cui l'applicazione ha già handle è invariato. Prima di chiamare lineGetConfRelatedCalls, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

Nota Se i parametri di dimensione nella struttura non sono corretti, è possibile che i dati vengano sovrascritti. Per altre informazioni sull'impostazione delle dimensioni della struttura, vedere l'argomento relativo all'allocazione della memoria .

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Commenti

La chiamata specificata può essere un handle di conferenza telefonica o un handle per una chiamata di partecipante. Ad esempio, una chiamata di consultazione che non è stata ancora aggiunta a una conferenza telefonica non fa parte di una conferenza. La prima voce nell'elenco restituito è l'handle della chiamata di conferenza, gli altri handle sono tutte le chiamate dei partecipanti. La chiamata specificata è sempre una delle chiamate restituite nell'elenco. Le chiamate nell'elenco a cui l'applicazione non dispone già di un handle di chiamata sono assegnati privilegi di monitoraggio; privilegi per le chiamate per cui l'applicazione dispone già di handle sono invariati. L'applicazione può usare lineSetCallPrivilege per modificare il privilegio della chiamata.

Se lineGetConfRelatedCalls viene chiamato immediatamente dopo l'aggiunta di una chiamata a una conferenza tramite lineCompleteTransfer, lineGetConfRelatedCalls potrebbe non restituire un elenco completo di chiamate correlate perché TAPI attende di ricevere un messaggio di LINE_CALLSTATE che indica che la chiamata è entrata LINECALLSTATE_CONFERENCED prima che consideri effettivamente la chiamata come parte della conferenza (vale a dire, lo stato conferenza è confermato dal provider di servizi. Dopo che l'applicazione ha ricevuto il messaggio LINE_CALLSTATE, lineGetConfRelatedCalls restituisce informazioni complete.

L'applicazione può richiamare lineGetCallInfo e lineGetCallStatus per ogni chiamata nell'elenco per determinare rispettivamente le informazioni e lo stato della chiamata.