LINETRANSLATEOUTPUT-Struktur (tapi.h)

Artikel
03/04/2024

Die LINETRANSLATEOUTPUT-Struktur beschreibt das Ergebnis einer Adressübersetzung. Die lineTranslateAddress-Funktion verwendet diese Struktur.

Syntax

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

Member

dwTotalSize

Dieser Datenstruktur zugeordnete Gesamtgröße in Byte.

dwNeededSize

Die Größe, die für diese Datenstruktur erforderlich ist, um alle zurückgegebenen Informationen in Bytes zu enthalten.

dwUsedSize

Größe des Teils dieser Datenstruktur, der nützliche Informationen in Byte enthält.

dwDialableStringSize

Größe der wählbaren Zeichenfolge in Byte, einschließlich der endenden NULL.

dwDialableStringOffset

Offset vom Anfang dieser Struktur zur übersetzten Ausgabe, die an die lineMakeCall-, lineDial- oder andere Funktion übergeben werden kann, die eine wählbare Zeichenfolge erfordert. Die Ausgabe ist immer eine NULL-endende Zeichenfolge. Hilfsfelder wie Name und Unteradresse sind in dieser Ausgabezeichenfolge enthalten, wenn sie sich in der Eingabezeichenfolge befinden. Diese Zeichenfolge kann private Informationen enthalten, z. B. das Aufrufen Karte Nummern. Es sollte dem Benutzer nicht angezeigt werden, um unbeabsichtigte Sichtbarkeit für unbefugte Personen zu verhindern. Die Größe des Felds wird durch dwDialableStringSize angegeben.

dwDisplayableStringSize

Größe der übersetzten Ausgabe, die dem Benutzer angezeigt werden kann, einschließlich des NULL-Abschlusszeichens , in Byte.

dwDisplayableStringOffset

Offset auf die übersetzte Ausgabe, die dem Benutzer zur Bestätigung angezeigt werden kann. Es ist identisch mit DialableString, mit dem Unterschied, dass die aufrufenden Karte Ziffern durch den Anzeigenamen der Karte in Klammern eingeschlossen werden (z. B. "[AT&T Card]"), und Nebenfelder wie Name und Unteradresse werden entfernt. Verwenden Sie eine entsprechende Meldung in dwDisplayableStringOffset, da die Zeichenfolge möglicherweise öffentlich im Dialogfeld call-status angezeigt wird. Diese Informationen sind auch für die Aufnahme in Anrufprotokolle geeignet. Die Größe des Felds wird durch dwDisplayableStringSize angegeben.

dwCurrentCountry

In CurrentLocation konfigurierter Länder- oder Regionscode. Dieser Wert kann verwendet werden, um die Anzeige durch die Anwendung bestimmter Benutzeroberflächenelemente, für die Erkennung des lokalen Anruffortschritts und für andere Zwecke zu steuern.

dwDestCountry

Zielland-/Regionscode der übersetzten Adresse. Dieser Wert kann an den dwCountryCode-Parameter von lineMakeCall und anderen Wählfunktionen übergeben werden (damit die Anruffortschrittstöne des Ziellandes/der Zielregion, z. B. ein ausgelastetes Signal), ordnungsgemäß erkannt werden. Dieses Feld wird auf null festgelegt, wenn die an lineTranslateAddress übergebene Zieladresse nicht im kanonischen Format vorliegt.

dwTranslateResults

Aus dem Übersetzungsprozess abgeleitete Informationen, die der Anwendung bei der Darstellung von Benutzeroberflächenelementen helfen können. Dieses Feld verwendet eine der LINETRANSLATERESULT_ Konstanten.