Avviare una sessione
Le informazioni principali fornite da un'applicazione per avviare una sessione di comunicazione sono il tipo di indirizzo, il tipo di supporto o i tipi e l'indirizzo di destinazione.
L'indirizzo di destinazione può richiedere la conversione degli indirizzi per inserire le informazioni immesse da un utente nel formato appropriato per un determinato tipo di indirizzo. Ad esempio, un numero di telefono incluso in una rubrica elettronica in formato canonico richiederà la traduzione in formato dialable .
Alcune sessioni possono richiedere parametri di installazione speciali, se supportati dal provider di servizi. Ad esempio, un TSP ISDN può trasmettere informazioni utente-utente e alcuni provider di servizi gestito richiedono informazioni sulla direzione del flusso multimediale. Per una revisione dei dati che possono essere impostati o ottenuti relativi a una sessione, vedere Informazioni sulla sessione.
Dopo l'avvio di una sessione, TAPI informerà l'applicazione dello stato di avanzamento della chiamata usando il meccanismo di notifica degli eventi configurato durante l'inizializzazione.
TAPI 2.x: le applicazioni avviano una sessione usando la funzione lineMakeCall . La funzione lineTranslateAddress viene usata per eseguire la conversione degli indirizzi, se necessario.
I parametri di configurazione delle chiamate possono essere archiviati nella struttura dei dati LINECALLPARAMS e un puntatore a questa struttura viene quindi usato come parametro di lineMakeCall. Se non viene fornita alcuna struttura LINECALLPARAMS a lineMakeCall, viene richiesta una chiamata di livello vocale POTS predefinita con un set di valori predefiniti.
Se la sessione è configurata correttamente, viene restituito un handle di chiamata con privilegi di proprietario all'applicazione e TAPI invia all'applicazione LINE_CALLSTATE messaggi con informazioni sullo stato della chiamata. Le applicazioni usano in genere questi messaggi per visualizzare i report di stato all'utente.
TAPI 3.x: le applicazioni avviano una sessione di comunicazione richiamando il metodo ITAddress::CreateCall in un indirizzo in grado di gestire il tipo di indirizzo e il tipo di supporto necessari. Se l'indirizzo espone l'interfaccia ITTerminalSupport , i terminali vengono selezionati nei flussi multimediali dell'oggetto chiamata. Per un'illustrazione di questo processo, vedere l'esempio di codice Make a Call .See the Make a Call code example for an illustration of this process.
I parametri di installazione delle chiamate possono essere archiviati o modificati usando metodi esposti dall'interfaccia ITCallInfo .
Se la sessione è configurata correttamente, TAPI restituisce un puntatore all'interfaccia ITBasicCallControl che può essere usato per altre operazioni di sessione o per ottenere un puntatore all'interfaccia ITCallInfo che può essere usato per acquisire informazioni aggiuntive sulla sessione. L'interfaccia ITCallStateEvent elabora gli eventi di stato delle chiamate TAPI.
Nota
TAPI non deve essere utilizzato per le trasmissioni fax. Usare invece le funzioni disponibili tramite MAPI, l'API Microsoft Messaggi.
Traduzione degli indirizzi
Un'applicazione server o un utente finale può archiviare gli indirizzi in un formato non compatibile con le esigenze di un determinato provider di servizi. Ad esempio, un numero di telefono può essere archiviato in una rubrica elettronica in formato canonico, ma la maggior parte dei provider di servizi che gestiscono i numeri di telefono richiedono il formato di composizione.
TAPI fornisce operazioni di conversione degli indirizzi che consentono a un'applicazione di presentare il tipo di indirizzo corretto a un TSP. Il provider di servizi specifica a TAPI quali tipi di indirizzi supporta e non deve includere alcuna forma di conversione degli indirizzi.
TAPI 2.x: vedere lineTranslateAddress.
TAPI 3: vedere ITAddressTranslation, ITAddressTranslationInfo.
Elenchi a pagamento
In alcune località in America del Nord, tutte le chiamate telefoniche effettuate al codice locale sono chiamate locali. In altre posizioni, alcune chiamate effettuate al codice dell'area locale sono lunghe e richiedono un prefisso "1" da comporre. Le prime tre cifre dell'indirizzo (prefisso) determinano se una chiamata all'interno del codice dell'area locale è una chiamata a pagamento.
Un elenco dei pedaggi è un elenco di prefissi nel codice dell'area locale i cui indirizzi devono essere comporre come indirizzi di lunga distanza e vengono valutati gli addebiti a lunga distanza.
Gli elenchi a pagamento non sono rilevanti per i provider di servizi o per le applicazioni che non accedono a una rete telefonica.
TAPI 2.x: vedere lineTranslateAddress (LINETRANSLATERESULT_INTOLLLIST e LINETRANSLATERESULT_NOTINTOLLLIST bit nella struttura LINETRANSLATEOUTPUT), lineSetTollList.
TAPI 3: vedere ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get_TranslationResults.