lineTranslateAddressA-Funktion (tapi.h)

Die lineTranslateAddress-Funktion übersetzt die angegebene Adresse in ein anderes Format.

Syntax

LONG lineTranslateAddressA(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

Parameter

hLineApp

Handle zurückgegeben von lineInitializeEx. Wenn eine TAPI 2.x-Anwendung die lineInitializeEx--Funktion noch nicht aufgerufen hat, kann dieser Parameter auf NULL-festgelegt werden. TAPI 1.4-Anwendungen müssen lineInitialize zuerst aufrufen.

dwDeviceID

Gerätebezeichner des Leitungsgeräts, auf dem der Anruf gewählt werden soll, sodass Variationen in Wählprozeduren in verschiedenen Zeilen auf den Übersetzungsprozess angewendet werden können.

dwAPIVersion

Höchste Version von TAPI, die von der Anwendung unterstützt wird (nicht unbedingt der von lineNegotiateAPIVersion auf einem bestimmten Liniengerät ausgehandelte Wert).

lpszAddressIn

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die die Adresse der Informationen enthält, die für die Übersetzung extrahiert werden sollen. Muss entweder im kanonischen Adressformat oder in einer beliebigen Zeichenfolge mit einwählbaren Ziffern (nicht kanonisch) angegeben sein. Dieser Parameter darf nicht NULL-sein. Wenn das AddressIn ein Unteradressen- oder Namensfeld oder zusätzliche Adressen enthält, die von der ersten Adresse durch CR- und LF-Zeichen getrennt sind, wird nur die erste Adresse übersetzt.

dwCard

Kreditkarte, die für die Wählhilfe verwendet werden soll. Dieser Parameter ist nur gültig, wenn das CARDOVERRIDE-Bit in dwTranslateOptions-festgelegt ist. Dieser Parameter gibt den dauerhaften Bezeichner eines Karteneintrags im Abschnitt [Karten] in der Registrierung an (wie aus lineTranslateCapsabgerufen), die anstelle der in der Definition der CurrentLocationangegebenen PreferredCard ID verwendet werden soll. Die PreferredCardID Parameter des aktuellen Location-Eintrags in der Registrierung wird nicht geändert; die Außerkraftsetzung gilt nur für den aktuellen Übersetzungsvorgang. Dieser Parameter wird ignoriert, wenn das CARDOVERRIDE-Bit nicht in dwTranslateOptionsfestgelegt ist.

dwTranslateOptions

Zugeordnete Vorgänge, die vor der Übersetzung der Adresse in eine einwählbare Zeichenfolge ausgeführt werden sollen. Dieser Parameter verwendet eine der LINETRANSLATEOPTION_ Konstanten.

Wenn Sie das LINETRANSLATEOPTION_CANCELCALLWAITING Bit festgelegt haben, empfiehlt es sich auch, das LINECALLPARAMFLAGS_SECURE Bit im dwCallParamFlags Member der LINECALLPARAMS- Struktur festzulegen (übergeben an lineMakeCallCall über den lpCallParams Parameter). Dadurch wird verhindert, dass das Leitungsgerät einwählbare Ziffern verwendet, um Anrufunterbrechungen zu unterdrücken.

lpTranslateOutput

Zeiger auf einen vom Anwendungs zugewiesenen Speicherbereich, der die Ausgabe des Übersetzungsvorgangs vom Typ LINETRANSLATEOUTPUTenthalten soll. Vor dem Aufrufen lineTranslateAddress-muss die Anwendung das dwTotalSize Mitglied dieser Struktur festlegen, um die Menge des für TAPI verfügbaren Arbeitsspeichers für die Rückgabe von Informationen anzugeben.

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_BADDEVICEID, LINEERR_INVALPOINTER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCARD, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPARAM.

Bemerkungen

Anmerkung

Der header tapi.h definiert lineTranslateAddress als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

Referenz zu grundlegenden Telefoniediensten

kanonische Adressen

LINECALLPARAMS-

LINETRANSLATEOUTPUT-

TAPI 2.2 Referenzübersicht

TAPI-Versionsverhandlung

lineInitializeEx-

lineNegotiateAPIVersion