Freigeben über


LINELOCATIONENTRY-Struktur (tapi.h)

Die LINELOCATIONENTRY-Struktur beschreibt einen Speicherort, der zum Bereitstellen eines Adressübersetzungskontexts verwendet wird. Die LINETRANSLATECAPS-Struktur kann ein Array von LINELOCATIONENTRY-Strukturen enthalten.

Syntax

typedef struct linelocationentry_tag {
  DWORD dwPermanentLocationID;
  DWORD dwLocationNameSize;
  DWORD dwLocationNameOffset;
  DWORD dwCountryCode;
  DWORD dwCityCodeSize;
  DWORD dwCityCodeOffset;
  DWORD dwPreferredCardID;
  DWORD dwLocalAccessCodeSize;
  DWORD dwLocalAccessCodeOffset;
  DWORD dwLongDistanceAccessCodeSize;
  DWORD dwLongDistanceAccessCodeOffset;
  DWORD dwTollPrefixListSize;
  DWORD dwTollPrefixListOffset;
  DWORD dwCountryID;
  DWORD dwOptions;
  DWORD dwCancelCallWaitingSize;
  DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;

Member

dwPermanentLocationID

Permanent sind. Gibt den Speicherort an.

dwLocationNameSize

Größe einer null-endenden Speicherortnamenszeichenfolge in Zeichen, einschließlich des NULL-Endzeichens.

dwLocationNameOffset

Offsetgröße, die in dwLocationNameSize angegeben ist, vom Anfang der LINETRANSLATECAPS-Struktur (die diesen Eintrag enthält) bis hin zu einer Zeichenfolge mit NULL-Beendigung, die den Speicherort auf benutzerfreundliche Weise beschreibt.

dwCountryCode

Landes- oder Regionscode des Standorts.

dwCityCodeSize

Größe der null-endenden Stadtcodezeichenfolge in Zeichen, einschließlich des NULL-endenden Zeichens.

dwCityCodeOffset

Offset, angegeben in dwCityCodeSize, vom Anfang dieser Struktur bis zu einer null-endenden Zeichenfolge, die den Orts-/Gebietscode angibt, der dem Standort zugeordnet ist. Diese Informationen mit dem Länder- oder Regionscode können von Anwendungen als "Standard"-Eingabefelder für den Benutzer bei der Eingabe von Telefonnummern verwendet werden, um die Eingabe der richtigen kanonischen Nummern zu fördern.

dwPreferredCardID

Bevorzugte Anrufe Karte, wenn Sie von diesem Standort aus wählen.

dwLocalAccessCodeSize

Größe der lokalen Zugriffscodezeichenfolge in Byte, einschließlich des NULL-Abschlusszeichens .

dwLocalAccessCodeOffset

Offsetgröße, die in dwLocalAccessCodeSize angegeben wird, vom Anfang der LINETRANSLATECAPS-Struktur bis zu einer null-endenden Zeichenfolge, die den Zugriffscode enthält, der vor Aufrufen von Adressen im lokalen Anrufbereich gewählt werden soll.

dwLongDistanceAccessCodeSize

Größe des Zugriffscodes für lange Entfernungen in Byte, einschließlich des NULL-Abschlusszeichens .

dwLongDistanceAccessCodeOffset

Offsetgröße, die in dwLongDistanceAccessCodeSize angegeben wird, vom Anfang der LINETRANSLATECAPS-Struktur bis zu einer NULL-terminierten Zeichenfolge, die den Zugriffscode enthält, der vor Anrufen von Adressen außerhalb des lokalen Anrufbereichs gewählt werden soll.

dwTollPrefixListSize

Größe des Mautpräfixes in Byte, einschließlich des NULL-Abschlusszeichens .

dwTollPrefixListOffset

Offsetgröße, die in dwTollPrefixListSize angegeben wird, vom Anfang der LINETRANSLATECAPS-Struktur bis zu einer Zeichenfolge mit Null-Beendigung, die die Liste der Gebührenpräfixe für den Speicherort enthält. Die Zeichenfolge enthält nur Präfixe, die aus den Ziffern "0" bis "9" bestehen und durch ein einzelnes Kommazeichen voneinander getrennt sind.

dwCountryID

Bezeichner des Lands/der Region, das/die für den Standort ausgewählt wurde. Dies kann mit der lineGetCountry-Funktion verwendet werden, um zusätzliche Informationen über das jeweilige Land/die region abzurufen, z. B. den Namen des Landes/der Region (das dwCountryCode-Mitglied kann für diesen Zweck nicht verwendet werden, da Länder-/Regionscodes nicht eindeutig sind).

dwOptions

Für diesen Speicherort gültige Optionen mit Werten aus dem LINELOCATIONOPTION_ Konstanten.

dwCancelCallWaitingSize

Größe der Zeichenfolge "cancel-call-waiting" in Byte.

dwCancelCallWaitingOffset

Offsetgröße, die in dwCancelCallWaitingSize angegeben wird, vom Anfang der LINETRANSLATECAPS-Struktur bis zu einer NULL-endenden Zeichenfolge, die die Ziffern und Modifizierer enthält, die der wählbaren Zeichenfolge (nach dem Impuls-/Tonzeichen) vorangestellt werden sollen, wenn eine Anwendung das LINETRANSLATEOPTION_CANCELCALLWAITING Bit im dwTranslateOptions-Parameter von lineTranslateAddress festlegt. Wenn kein Präfix definiert ist, kann dwCancelCallWaitingSize auf null oder 1 festgelegt werden, und dwCancelCallWaitingOffset kann auf eine leere Zeichenfolge (einzelnes NULL-Byte ) verweisen.

Hinweise

Diese Struktur kann nicht erweitert werden.

Ältere Anwendungen werden ohne Kenntnis dieser neuen Felder kompiliert und verwenden einen SIZEOF LINELOCATIONENTRY, der kleiner als die neue Größe ist. Da es sich um ein Array im Variablenteil einer LINETRANSLATECAPS-Struktur handelt, ist es zwingend erforderlich, dass ältere Anwendungen LINELOCATIONENTRY-Strukturen in dem zuvor erwarteten Format empfangen, oder sie können das Array nicht ordnungsgemäß indizieren. Die Anwendung übergibt einen dwAPIVersion-Parameter mit der lineGetTranslateCaps-Funktion , die von TAPI zur Behandlung dieser Situation verwendet werden kann. Die lineGetTranslateCaps-Funktion sollte beim Erstellen der LINETRANSLATECAPS-Struktur, die an die Anwendung zurückgegeben werden soll, die LINELOCATIONENTRY-Member und -Größe verwenden, die der angegebenen API-Version entsprechen.

Anforderungen

Anforderung Wert
Header tapi.h

Weitere Informationen

LINETRANSLATECAPS

lineGetCountry

lineGetTranslateCaps

lineTranslateAddress