funzione lineGetCallStatus (tapi.h)

Articolo
08/26/2023

La funzione lineGetCallStatus restituisce lo stato corrente della chiamata specificata.

Sintassi

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

Parametri

hCall

Gestire la chiamata da eseguire una query. Lo stato della chiamata di hCall può essere qualsiasi stato.

lpCallStatus

Puntatore a una struttura di dati di dimensioni variabile di tipo LINECALLSTATUS. Al termine della richiesta, questa struttura viene riempita con informazioni sullo stato delle chiamate. Prima di chiamare lineGetCallStatus, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire informazioni.

Nota Se i parametri delle dimensioni nella struttura non sono corretti, è possibile che i dati possano essere 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 un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

La funzione lineGetCallStatus restituisce lo stato dinamico di una chiamata, mentre lineGetCallInfo restituisce principalmente informazioni statiche su una chiamata. Le informazioni sullo stato della chiamata includono lo stato della chiamata corrente, informazioni dettagliate sulla modalità correlate alla chiamata mentre in questo stato (se presente), nonché un elenco delle funzioni API disponibili che l'applicazione può richiamare sulla chiamata mentre la chiamata è in questo stato. Un'applicazione in genere è interessata a richiedere queste informazioni quando riceve una notifica relativa a una modifica dello stato della chiamata dal messaggio LINE_CALLSTATE.