Costanti LINEDISCONNECTMODE_
Le costanti LINEDISCONNECTMODE_ flag di bit descrivono diversi motivi per una richiesta di disconnessione remota. Una modalità di disconnessione è disponibile come stato della chiamata all'applicazione dopo la transizione dello stato della chiamata a disconnesso.
-
LINEDISCONNECTMODE_BADADDRESS
-
-
L'indirizzo di destinazione non è valido.
-
-
LINEDISCONNECTMODE_BLOCKED
-
-
Impossibile connettere la chiamata perché le chiamate dall'indirizzo di origine non vengono accettate nell'indirizzo di destinazione. Ciò è diverso da LINEDISCONNECTMODE_REJECT in quanto il blocco viene implementato nella rete (un rifiuto passivo) mentre un rifiuto viene implementato nell'apparecchiatura di destinazione (un rifiuto attivo). Il blocco può essere dovuto a un'esclusione specifica dell'indirizzo di origine o perché la destinazione accetta chiamate solo da un set selezionato di indirizzi di origine (gruppo di utenti chiusi). (TAPI versioni 2.0 e successive)
LINEDISCONNECTMODE_BLOCKED è appropriato come risposta bloccata. Ad esempio, un modem ha ricevuto una risposta, ha superato più di sei secondi senza rilevare il ringback, non è riuscito a connettere un numero definito di volte, determina che il numero di telefono non è valido per la chiamata e rilascia una risposta 'blocklisted'.
-
-
LINEDISCONNECTMODE_BUSY
-
-
La stazione dell'utente remoto è occupata.
-
-
LINEDISCONNECTMODE_CANCELLED
-
-
La chiamata è stata annullata. (TAPI versioni 2.0 e successive)
-
-
LINEDISCONNECTMODE_CONGESTION
-
-
La rete è congestionata.
-
-
LINEDISCONNECTMODE_DONOTDISTURB
-
-
Impossibile connettere la chiamata perché la destinazione ha richiamato la funzionalità Non disturbare. (TAPI versioni 2.0 e successive)
-
-
LINEDISCONNECTMODE_FORWARDED
-
-
La chiamata è stata inoltrata dall'opzione.
-
-
LINEDISCONNECTMODE_INCOMPATIBLE
-
-
L'apparecchiatura stazione dell'utente remoto non è compatibile con il tipo di chiamata richiesta.
-
-
LINEDISCONNECTMODE_NOANSWER
-
-
La stazione dell'utente remoto non risponde.
-
-
LINEDISCONNECTMODE_NODIALTONE
-
-
Non è stato rilevato un tono di chiamata all'interno di un timeout definito dal provider di servizi, in un punto durante la composizione quando era previsto un segnale di chiamata, ad esempio in corrispondenza di "W" nella stringa chiamabile. Ciò può verificarsi anche senza un periodo di timeout definito dal provider di servizi o senza un valore specificato nel membro dwWaitForDialTone della struttura LINEDIALPARAMS . (TAPI versioni 1.4 e successive)
-
-
LINEDISCONNECTMODE_NORMAL
-
-
Si tratta di una normale richiesta di disconnessione da parte dell'entità remota. La chiamata è stata terminata normalmente.
-
-
LINEDISCONNECTMODE_NUMBERCHANGED
-
-
Impossibile connettere la chiamata perché il numero di destinazione è stato modificato, ma non viene fornito il reindirizzamento automatico al nuovo numero. (TAPI versioni 2.0 e successive)
-
-
LINEDISCONNECTMODE_OUTOFORDER
-
-
La chiamata non è stata connessa o è stata disconnessa perché il dispositivo di destinazione non è in ordine (errore hardware). (TAPI versioni 2.0 e successive)
-
-
LINEDISCONNECTMODE_PICKUP
-
-
La chiamata è stata prelevata da un'altra parte.
-
-
LINEDISCONNECTMODE_QOSUNAVAIL
-
-
Impossibile connettere o disconnettere la chiamata perché non è stato possibile ottenere o sostenere la qualità minima del servizio. Ciò è diverso da LINEDISCONNECTMODE_INCOMPATIBLE in quanto la mancanza di risorse può essere una condizione temporanea nella destinazione. (TAPI versioni 2.0 e successive)
-
-
LINEDISCONNECTMODE_REJECT
-
-
L'utente remoto ha rifiutato la chiamata.
-
-
LINEDISCONNECTMODE_TEMPFAILURE
-
-
La chiamata non è stata connessa o è stata disconnessa a causa di un errore temporaneo nella rete; la chiamata può essere annullata in un secondo momento e dovrebbe essere completata. (TAPI versioni 2.0 e successive)
LINEDISCONNECTMODE_TEMPFAILURE è appropriato come risposta ritardata. Ad esempio, un modem riceve un segnale occupato o un numero eccessivo di volte in un determinato periodo di tempo conclude che il numero non deve essere chiamato di nuovo fino a quando non è trascorso un tempo definito e genera una risposta "ritardata".
-
-
LINEDISCONNECTMODE_UNAVAIL
-
-
Il motivo della disconnessione non è disponibile e non sarà più noto in seguito.
-
-
LINEDISCONNECTMODE_UNKNOWN
-
-
Il motivo della richiesta di disconnessione è sconosciuto, ma potrebbe diventare noto in un secondo momento.
-
-
LINEDISCONNECTMODE_UNREACHABLE
-
-
Impossibile raggiungere l'utente remoto.
-
Commenti
È possibile assegnare 16 bit di ordine elevato per le estensioni specifiche del dispositivo. I 16 bit di ordine basso sono riservati.
Una richiesta di disconnessione remota per una determinata chiamata comporta la transizione dello stato della chiamata allo stato disconnesso e un messaggio LINE_CALLSTATE viene inviato all'applicazione. Le informazioni LINEDISCONNECTMODE_ forniscono informazioni dettagliate sulla richiesta di disconnessione remota. È disponibile nella struttura LINECALLSTATUS della chiamata quando la chiamata si trova nello stato disconnesso. Mentre una chiamata è in questo stato, l'applicazione è ancora autorizzata a eseguire query sulle informazioni e sullo stato della chiamata. Ad esempio, le informazioni utente-utente ricevute come parte della disconnessione remota sono quindi disponibili. L'applicazione può cancellare una chiamata disconnessa eliminando la chiamata.
Per garantire la compatibilità con le versioni precedenti, è responsabilità del provider di servizi esaminare la versione negoziata dell'API nella riga e non usare questo valore LINEDISCONNECTMODE_ se non è supportato nella versione negoziata (è possibile usare LINEDISCONNECTMODE_NORMAL o _UNKNOWN).
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|