funzione TSPI_lineRedirect (tspi.h)

Articolo
03/03/2024

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

Sintassi

LONG TSPIAPI TSPI_lineRedirect(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle della chiamata da reindirizzare. Lo stato della chiamata di hdCall può essere offerto.

lpszDestAddress

Puntatore a una stringa Unicode con terminazione Null che specifica l'indirizzo di destinazione. Segue il formato di collegamento standard.

dwCountryCode

Il codice paese o area geografica dell'entità a cui viene reindirizzata la chiamata. Se viene specificato un valore pari a 0, viene utilizzato un valore predefinito dall'implementazione. Questo parametro non viene convalidato da TAPI quando questa funzione viene chiamata.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCOUNTRYCODE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.

Commenti

Il provider di servizi non reindirizza la chiamata se restituisce LINEERR_INVALADDRESS.

Quando questa funzione viene richiamata, il provider di servizi defleta la 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 di chiamata viene eseguito dal commutatore senza il coinvolgimento della stazione chiamata; il reindirizzamento può essere eseguito su una chiamata per chiamata da un'applicazione client, ad esempio in base alle informazioni sull'ID chiamante. Differisce dal trasferimento delle chiamate in quanto il trasferimento di una chiamata richiede che la chiamata venga prima risposta.

Dopo il reindirizzamento di una chiamata, la chiamata passa in genere all'inattività. Il provider di servizi indica il nuovo stato utilizzando un messaggio di LINE_CALLSTATE .