funzione lineGetNewCalls (tapi.h)

Articolo
03/05/2024

La funzione lineGetNewCalls restituisce handle delle chiamate a chiamate su una riga o un indirizzo specificato per cui l'applicazione attualmente non dispone di handle. L'applicazione ha concesso il privilegio di monitoraggio a queste chiamate.

Sintassi

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

Parametri

hLine

Gestire in un dispositivo a riga aperta.

dwAddressID

Indirizzo nel dispositivo open line specificato. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwSelect

Selezione di chiamate richieste. Questo parametro usa uno e solo uno dei costanti LINECALLSELECT_.

lpCallList

Puntatore a una struttura di dati di dimensioni variabile di tipo LINECALLLIST. Al termine della richiesta, gli handle di chiamata a tutte le chiamate selezionate vengono restituiti in questa struttura. Prima di chiamare lineGetNewCalls, 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_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Commenti

Un'applicazione può usare lineGetNewCalls per ottenere handle per le chiamate per cui attualmente non dispone di handle. L'applicazione può selezionare le chiamate per le quali gli handle devono essere restituiti basando questa selezione sull'ambito (chiamate su una riga specificata o chiamate su un indirizzo specificato). Ad esempio, un'applicazione può richiedere handle di chiamata a tutte le chiamate in un determinato indirizzo per cui attualmente non ha alcun handle. L'applicazione viene sempre assegnato il privilegio di monitoraggio ai nuovi handle di chiamata. Inoltre, quando si apre una riga, un'applicazione usa questa funzione per diventare consapevoli delle chiamate esistenti.

L'applicazione può richiamare lineGetCallInfo e lineGetCallStatus per ogni chiamata nell'elenco per determinare rispettivamente le informazioni e lo stato della chiamata. Può usare lineSetCallPrivilege per modificare il proprio privilegio al proprietario.