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 |