Funzione lineRedirect (tapi.h)

Articolo
03/02/2024

La funzione lineRedirect reindirizza la chiamata dell'offerta specificata all'indirizzo di destinazione specificato.

Sintassi

LONG lineRedirect(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Parametri

hCall

Gestire la chiamata da reindirizzare. L'applicazione deve essere un proprietario della chiamata. Lo stato della chiamata di hCall deve essere disponibile.

lpszDestAddress

Puntatore all'indirizzo di destinazione. Segue il formato standard del numero chiamabile.

dwCountryCode

Il codice paese dell'entità a cui viene reindirizzata la chiamata. Se viene specificato un valore pari a 0, viene utilizzato un valore predefinito dall'implementazione.

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_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Commenti

Il reindirizzamento chiamate consente a un'applicazione di disattivare una chiamata di offerta a un altro indirizzo senza prima rispondere alla chiamata. Il reindirizzamento delle chiamate differisce dall'inoltro delle chiamate in quanto l'inoltro delle chiamate viene eseguito dall'opzione senza il coinvolgimento dell'applicazione; il reindirizzamento può essere eseguito in base a una chiamata tramite chiamata dall'applicazione, ad esempio, in base alle informazioni sull'ID chiamante. Differisce dal trasferimento delle chiamate in quanto il trasferimento di una chiamata richiede prima di tutto la risposta alla chiamata.

Dopo che una chiamata è stata reindirizzata correttamente, la chiamata passa in genere a inattiva.

Oltre a reindirizzare una chiamata in arrivo, un'applicazione può avere la possibilità di accettare la chiamata tramite lineAccept, rifiutare la chiamata usando lineDrop o rispondere alla chiamata usando lineAnswer. La disponibilità di queste operazioni dipende dalle funzionalità del dispositivo.