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 traduzione 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 che era in una rubrica elettronica in formato canonico richiederà la traduzione in formato dialable .

Alcune sessioni possono richiedere parametri di configurazione speciali, se supportati dal provider di servizi. Ad esempio, un provider di servizi di rete ISDN può trasmettere informazioni utente-utente e alcuni provider di servizi di rete richiedono informazioni sulla direzione del flusso multimediale. Per una revisione dei dati che possono essere impostati o ottenuti per 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 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 installazione delle chiamate possono essere archiviati nella struttura di 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 viene configurata correttamente, viene restituito un handle di chiamata con privilegidi proprietarioall'applicazione e TAPI invia all'applicazione LINE_CALLSTATE messaggi con informazioni sull'avanzamento della chiamata. Le applicazioni in genere usano questi messaggi per visualizzare i report sullo 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 call. Per un'illustrazione di questo processo, vedere l'esempio Di codice Di una chiamata .

I parametri di installazione delle chiamate possono essere archiviati o modificati usando metodi esposti dall'interfaccia ITCallInfo .

Se la sessione viene configurata correttamente, TAPI restituisce un puntatore dell'interfaccia ITBasicCallControl che può essere usato per ulteriori operazioni di sessione o per ottenere un puntatore dell'interfaccia ITCallInfo che può essere usato per acquisire informazioni aggiuntive sulla sessione. L'interfaccia ITCallStateEvent elabora gli eventi di stato di chiamata TAPI.

Nota

TAPI non deve essere usato per le trasmissioni fax. Usare invece le funzioni disponibili tramite MAPI, l'API Microsoft Messaggi.

 

Traduzione degli indirizzi

Un'applicazione end-user o server 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 un indirizzo elettronico in formato canonico, ma la maggior parte dei provider di servizi che gestiscono i numeri di telefono richiedono il formato dialable.

TAPI fornisce operazioni di traduzione 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 traduzione degli indirizzi.

TAPI 2.x: Vedere lineTranslateAddress.

TAPI 3: Vedere ITAddressTranslation, ITAddressTranslationInfo.

Elenchi di pedaggi

In alcune posizioni in America del Nord, tutte le chiamate telefoniche inserite nel codice dell'area locale sono chiamate locali. In altre posizioni, alcune chiamate inserite nel codice dell'area locale sono a lunga distanza e devono essere digitati un prefisso "1". Le prime tre cifre dell'indirizzo (prefisso) determinano se una chiamata all'interno del codice dell'area locale è una chiamata a pedaggio.

Un elenco dei pedaggi è un elenco di prefissi nel codice dell'area locale i cui indirizzi devono essere digitati come indirizzi a distanza prolungata e vengono valutati addebiti a distanza prolungata.

Gli elenchi di pedaggi 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.