Initiieren einer Sitzung
Die wichtigsten Informationen, die eine Anwendung zum Initiieren einer Kommunikationssitzung liefert, sind der Adresstyp, der Medientyp oder 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 setzen. Beispielsweise erfordert eine Telefonnummer in einem elektronischen Adressbuch im kanonischen Format eine Übersetzung in das Wählformat.
Einige Sitzungen erfordern möglicherweise spezielle Setupparameter, wenn sie vom Dienstanbieter unterstützt werden. Beispielsweise kann ein ISDN-TSP Benutzer-Benutzerinformationen übertragen, und einige MSPs erfordern Informationen zur Richtung des Medienstreams. Eine Überprüfung der Daten, die für eine Sitzung festgelegt oder erhalten werden können, finden Sie unter Sitzungsinformationen.
Nachdem eine Sitzung initiiert wurde, informiert TAPI die Anwendung über den Aufruffortschritt mithilfe des während der Initialisierung eingerichteten Ereignisbenachrichtigungsmechanismus.
TAPI 2.x: Anwendungen initiieren eine Sitzung mithilfe der lineMakeCall-Funktion. Die lineTranslateAddress-Funktion wird bei Bedarf zum Durchführen der Adressübersetzung verwendet.
Aufrufeinrichtungsparameter können in der LINECALLPARAMS-Datenstruktur gespeichert werden, und ein Zeiger auf diese Struktur wird dann als Parameter von lineMakeCall verwendet. Wenn lineMakeCall keine LINECALLPARAMS-Struktur bereitgestellt wird, wird ein STANDARD-VOICE-Anruf mit einem Satz von Standardwerten angefordert.
Wenn die Sitzung erfolgreich eingerichtet wurde, wird ein Aufrufhand handle mit Besitzerberechtigungen an die Anwendung zurückgegeben, und TAPI sendet die LINE _ CALLSTATE-Nachrichten der Anwendung mit Informationen zum Status des Aufrufs. Anwendungen verwenden diese Meldungen in der Regel, um dem Benutzer Statusberichte anzuzeigen.
TAPI 3.x: Anwendungen initiieren eine Kommunikationssitzung, indem sie die ITAddress::CreateCall-Methode für eine Adresse aufrufen, die den erforderlichen Adresstyp und Medientyp behandeln kann. Wenn die Adresse die ITTerminalSupport-Schnittstelle verfügbar macht, werden Terminals in den Medienstreams des Aufrufobjekts ausgewählt. Eine Veranschaulichung dieses Prozesses finden Sie im Beispiel zum Ausführen eines Aufrufcodes.
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 ITBasicCallControl-Schnittstellenzeiger zurück, der für weitere Sitzungsvorgänge oder zum Abrufen eines ITCallInfo-Schnittstellenzeigers verwendet werden kann, der zum Abrufen zusätzlicher Sitzungsinformationen verwendet werden kann. Die ITCallStateEvent-Schnittstelle verarbeitet TAPI-Aufrufzustandsereignisse.
Hinweis
TAPI sollte nicht für Faxübertragungen verwendet werden. Verwenden Sie stattdessen die Funktionen, die über MAPI verfügbar sind, die Microsoft-Nachrichten API.
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ählformat.
TAPI stellt Adressübersetzungsvorgänge zur Verfügung, die eine Anwendung bei der Präsentation des richtigen Adresstyps für einen TSP unterstützen. Der Dienstanbieter gibt TAPI an, welche Adresstypen unterstützt werden, und 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 in der Ortsvorwahl Ortsanrufe. An anderen Orten sind einige Aufrufe der Ortsvorwahl weit entfernt und benötigen das Präfix "1", um gewählt werden zu können. Die ersten drei Ziffern der Adresse (das Präfix) bestimmen, ob ein Aufruf in der Ortsvorwahl ein Mautaufruf ist.
Eine Mautliste ist eine Liste von Präfixen in der Ortsvorwahl, deren Adressen als Fernadressen gewählt werden müssen und für die Gebühren für die Fernverbindung berechnet werden.
Mautlisten sind für Dienstanbieter oder 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: Weitere Informationen finden Sie unter ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get _ TranslationResults.