Initiieren einer Sitzung
Die wichtigsten Informationen, die eine Anwendung zum Initiieren einer Kommunikationssitzung bereitstellt, sind der Adresstyp, der/die Medientyp(en) und die Zieladresse.
Die Zieladresse erfordert möglicherweise eine Adressenübersetzung, um die von einem Benutzer eingegebenen Informationen im für einen bestimmten Adresstyp korrekten Format einzufügen. Beispielsweise erfordert eine Telefonnummer, die sich in einem elektronischen Adressbuch im kanonischen Format befand, eine Übersetzung in ein wählbares Format.
Manche Sitzungen erfordern möglicherweise spezielle Einrichtungsparameter, wenn sie vom Dienstanbieter unterstützt werden. Beispielsweise kann ein ISDN-TSP Benutzerinformationen übertragen, und einige MSPs erfordern Informationen zur Medienstreamrichtung. Unter Sitzungsinformationen finden Sie Informationen zu Daten, die für eine Sitzung eingerichtet oder abgerufen werden können.
Sobald eine Sitzung initiiert wurde, informiert TAPI die Anwendung über den Fortschritt des Gesprächs anhand des während der Initialisierung eingerichteten Ereignisbenachrichtigungsmechanismus.
TAPI 2.x: Anwendungen initiieren eine Sitzung mithilfe der Funktion lineMakeCall. Die Funktion lineTranslateAddress wird verwendet, um bei Bedarf Adressenübersetzungen durchzuführen.
Einrichtungsparameter für Anrufe können in der Datenstruktur LINECALLPARAMS gespeichert werden; dann wird ein verweis auf diese Struktur als Parameter von lineMakeCall verwendet. Wenn keine LINECALLPARAMS-Struktur für lineMakeCall bereitgestellt wird, wird ein Standard-POTS-Sprachanruf mit einer Reihe von Standardwerten angefordert.
Wenn die Sitzung erfolgreich eingerichtet wurde, wird ein Anrufhandle mit Eigentümer -Rechten an die Anwendung zurückgegeben, und TAPI sendet der Anwendung LINE_CALLSTATE-Nachrichten mit Informationen zum Fortschritt des Anrufs. Anwendungen verwenden diese Meldungen in der Regel zum Anzeigen von Statusberichten für Benutzer.
TAPI 3.x: Anwendungen initiieren eine Kommunikationssitzung, indem sie die ITAddress::CreateCall-Methode für eine Adresse aufrufen, die den erforderlichen Adresstyp und Medientyp verarbeiten kann. Wenn die Adresse die ITTerminalSupporte-Schnittstelle verfügbar macht, werden Terminals auf den Mediendatenströmen des Aufrufobjekts ausgewählt. Eine Illustration dieses Prozesses finden Sie im Codebeispiel zum Tätigen eines Anrufs.
Aufrufeinrichtungsparameter 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 Verweis auf die ITBasicCallControl-Schnittstelle zurück, der für weitere Sitzungsvorgänge verwendet werden kann, oder um einen Verweis auf die ITCallInfo-Schnittstelle abzurufen, der für den Abruf weiterer Sitzungsinformationen verwendet werden kann. Die ITCallStateEvent-Schnittstelle verarbeitet TAPI-Anrufstatus-Ereignisse.
Hinweis
TAPI sollte nicht für Faxübertragungen verwendet werden. Verwenden Sie stattdessen die über MAPI, die Microsoft Messaging API, verfügbaren Funktionen.
Adressenübersetzung
Eine Endbenutzer- oder Serveranwendung speichert möglicherweise Adressen in einem Format, das nicht mit den Anforderungen eines bestimmten Dienstanbieters kompatibel ist. Beispielsweise kann eine Telefonnummer in einem elektronischen Adressbuch im kanonischen Format gespeichert sein, die meisten Dienstanbieter, die Telefonnummern verarbeiten, jedoch das wählbare Format erfordern.
TAPI stellt Adressenübersetzungsfunktionen bereit, die eine Anwendung bei der Darstellung des korrekten Adresstyps für einen TSP unterstützen. Der Dienstanbieter gibt gegenüber TAPI an, welche Adresstypen unterstützt werden, und muss selbst keine Adressenübersetzung vornehmen.
TAPI 2.x: Siehe lineTranslateAddress.
TAPI 3: Siehe ITAddressTranslation, ITAddressTranslationInfo.
Toll Lists
An manchen Orten in Nordamerika sind alle Telefonanrufe, die mit der entsprechenden Ortsvorwahl getätigt werden, Ortsgespräche. An anderen Orten sind manche Anrufe, die mit der Ortsvorwahl getätigt werden, Ferngespräche, bei denen der Nummer eine „1“ vorangestellt werden muss. Die ersten drei Ziffern der Adresse (das Präfix) legen fest, ob es sich bei einem Anruf mit der Ortsvorwahl um einen gebührenpflichtigen Anruf handelt.
Eine Toll List ist eine Liste der Präfixe innerhalb der Ortsvorwahl, deren Adresse gewählt werden muss, um Ferngespräche (zu entsprechenden Gebühren) zu führen.
Toll Lists sind für Dienstanbieter oder für Anwendungen, die nicht auf ein Telefonnetzwerk zugreifen, nicht relevant.
TAPI 2.x: Siehe lineTranslateAddress (LINETRANSLATERESULT_INTOLLLIST und LINETRANSLATERESULT_NOTINTOLLLIST-Bits in der LINETRANSLATEOUTPUT-Struktur), lineSetTollList.
TAPI 3: Siehe ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get_TranslationResults.