lineTranslateAddress-Funktion (tapi.h)

Artikel
08/26/2023

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

Syntax

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

Parameter

hLineApp

Von lineInitializeEx zurückgegebenes Handle. Wenn eine TAPI 2.x-Anwendung die lineInitializeEx-Funktion noch nicht aufgerufen hat, kann sie diesen Parameter auf NULL festlegen. TAPI 1.4-Anwendungen müssen weiterhin lineInitialize zuerst aufrufen.

dwDeviceID

Gerätebezeichner des Leitungsgeräts, auf dem der Anruf gewählt werden soll, sodass Variationen der Wählverfahren für verschiedene 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 Zeilengerät ausgehandelte Wert).

lpszAddressIn

Zeiger auf eine NULL-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 durchwählbaren Ziffern (nicht kanonisch) vorliegen. Dieser Parameter darf nicht NULL sein. Wenn 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

Guthaben Karte, die für die Wahl verwendet werden sollen. Dieser Parameter ist nur gültig, wenn das CARDOVERRIDE-Bit in dwTranslateOptions festgelegt ist. Dieser Parameter gibt den permanenten Bezeichner eines Karteneintrags im Abschnitt [Karten] in der Registrierung an (wie von lineTranslateCaps abgerufen), der anstelle der in der Definition von CurrentLocation angegebenen PreferredCardID verwendet werden soll. Es bewirkt nicht, dass der PreferredCardID-Parameter des aktuellen Location-Eintrags in der Registrierung geändert wird. die Überschreibung gilt nur für den aktuellen Übersetzungsvorgang. Dieser Parameter wird ignoriert, wenn das CARDOVERRIDE-Bit in dwTranslateOptions nicht festgelegt ist.

dwTranslateOptions

Zugeordnete Vorgänge, die vor der Übersetzung der Adresse in eine durchwählbare Zeichenfolge ausgeführt werden müssen. 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-Element der LINECALLPARAMS-Struktur festzulegen (wird über den lpCallParams-Parameter an lineMakeCallCall übergeben). Dadurch wird verhindert, dass das Leitungsgerät einwählbare Ziffern verwendet, um Anrufunterbrechungen zu unterdrücken.

lpTranslateOutput

Zeiger auf einen anwendungsseitig zugewiesenen Speicherbereich, der die Ausgabe des Übersetzungsvorgangs vom Typ LINETRANSLATEOUTPUT enthält. Vor dem Aufrufen von lineTranslateAddress muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, der TAPI zum Zurückgeben von Informationen zur Verfügung steht.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, 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.