Initiieren einer Sitzung

Die wichtigsten Informationen, die eine Anwendung zum Initiieren einer Kommunikationssitzung bereitstellt, sind der Adresstyp, der Bzw. die Medientypen und die Zieladresse.

Die Zieladresse erfordert möglicherweise eine Adressübersetzung , um die von einem Benutzer eingegebenen Informationen in das richtige Format für einen bestimmten Adresstyp zu versetzen. Beispielsweise muss eine Telefonnummer, die sich in einem elektronischen Adressbuch im kanonischen Format befand, in ein durchwahlbares Format übersetzt werden.

Einige Sitzungen erfordern möglicherweise spezielle Setupparameter, wenn sie vom Dienstanbieter unterstützt werden. Beispielsweise kann ein ISDN-TSP Benutzerinformationen übertragen, und einige MSPs benötigen Informationen zur Richtung des Medienstroms. Informationen zur Überprüfung von Daten, die für eine Sitzung festgelegt oder abgerufen werden können, finden Sie unter Sitzungsinformationen .

Sobald eine Sitzung initiiert wurde, informiert TAPI die Anwendung über den Anrufstatus mithilfe des während der Initialisierung eingerichteten Ereignisbenachrichtigungsmechanismus.

TAPI 2.x: Anwendungen initiieren eine Sitzung mit der lineMakeCall-Funktion . Die Funktion lineTranslateAddress wird verwendet, um bei Bedarf die Adressübersetzung durchzuführen.

Aufrufsetupparameter können in der LINECALLPARAMS-Datenstruktur gespeichert werden, und ein Zeiger auf diese Struktur wird dann als Parameter von lineMakeCall verwendet. Wenn keine LINECALLPARAMS-Struktur für lineMakeCall bereitgestellt wird, wird ein POTS-Standardanruf mit einer Reihe von Standardwerten angefordert.

Wenn die Sitzung erfolgreich eingerichtet wurde, wird ein Anrufhandle mit Besitzerberechtigungen an die Anwendung zurückgegeben, und TAPI sendet die Anwendung LINE_CALLSTATE Nachrichten mit Informationen zum Fortschritt des Anrufs. Anwendungen verwenden diese Meldungen in der Regel, um dem Benutzer status Berichte anzuzeigen.

TAPI 3.x: Anwendungen initiieren eine Kommunikationssitzung, indem sie die ITAddress::CreateCall-Methode für eine Adresse aufrufen, die den Adress- und Medientyp verarbeiten kann. Wenn die Adresse die ITTerminalSupport-Schnittstelle verfügbar macht, werden Terminals für die Medienströme des Aufrufobjekts ausgewählt. Eine Abbildung dieses Prozesses finden Sie im Codebeispiel zum Erstellen eines Anrufs .

Aufrufsetupparameter können mithilfe von Methoden gespeichert oder geändert werden, die von der ITCallInfo-Schnittstelle verfügbar gemacht werden.

Wenn die Sitzung erfolgreich eingerichtet wurde, gibt TAPI einen ITBasicCallControl-Schnittstellenzeiger zurück, der für weitere Sitzungsvorgänge oder zum Abrufen eines ITCallInfo-Schnittstellenzeigers verwendet werden kann, mit dem zusätzliche Sitzungsinformationen abgerufen werden können. Die ITCallStateEvent-Schnittstelle verarbeitet TAPI-Aufrufzustandsereignisse.

Hinweis

TAPI sollte nicht für Faxübertragungen verwendet werden. Verwenden Sie stattdessen die Funktionen, die über MAPI, die Microsoft Messaging-API, verfügbar sind.

 

Adressübersetzung

Eine Endbenutzer- oder Serveranwendung kann Adressen in einem Format speichern, das nicht mit den Anforderungen eines bestimmten Dienstanbieters kompatibel ist. Beispielsweise kann eine Telefonnummer in einem elektronischen Adressbuch im kanonischen Format gespeichert werden, aber die meisten Dienstanbieter, die Telefonnummern verarbeiten, benötigen das wählbare Format.

TAPI stellt Adressübersetzungsvorgänge bereit, die eine Anwendung bei der Darstellung des richtigen Adresstyps für einen TSP unterstützen. Der Dienstanbieter gibt tapi an, welche Adresstypen er unterstützt, und er muss keine Form der Adressübersetzung enthalten.

TAPI 2.x: Siehe lineTranslateAddress.

TAPI 3: Siehe ITAddressTranslation, ITAddressTranslationInfo.

Mautlisten

An einigen Orten in Nordamerika sind alle Telefonanrufe, die an die Ortsvorwahl getätigt werden, Ortsgespräche. An anderen Standorten sind einige Aufrufe der lokalen Vorwahl weit entfernt und benötigen ein Präfix "1", um gewählt zu werden. Die ersten drei Ziffern der Adresse (das Präfix) bestimmen, ob ein Anruf innerhalb der lokalen Vorwahl ein gebührenpflichtiger Anruf ist.

Eine Mautliste ist eine Liste von Präfixen in der lokalen Ortsvorwahl, deren Adressen als Fernadressen gewählt werden müssen und die für fernen Strecken berechnet werden.

Mautlisten sind weder für Dienstleister noch für Anwendungen relevant, die nicht auf ein Telefonnetz zugreifen.

TAPI 2.x: Siehe lineTranslateAddress (LINETRANSLATERESULT_INTOLLLIST und LINETRANSLATERESULT_NOTINTOLLLIST Bits in der LINETRANSLATEOUTPUT-Struktur ), lineSetTollList.

TAPI 3: Siehe ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get_TranslationResults.