funzione lineGetCallInfo (tapi.h)

Articolo
08/26/2023

La funzione lineGetCallInfo consente a un'applicazione di ottenere informazioni fisse sulla chiamata specificata.

Sintassi

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

Parametri

hCall

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

lpCallInfo

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

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

Esiste una struttura LINECALLINFO separata per ogni chiamata in ingresso o in uscita. La struttura contiene principalmente informazioni fisse sulla chiamata. Un'applicazione in genere è interessato a controllare queste informazioni quando riceve il relativo handle per una chiamata dal messaggio LINE_CALLSTATE o ogni volta che riceve una notifica da un messaggio LINE_CALLINFO che parti della struttura delle informazioni di chiamata sono state modificate. Questi messaggi forniscono l'handle per la chiamata come parametro.