LINECARDENTRY-Struktur (tapi.h)

Die LINECARDENTRY-Struktur beschreibt einen aufrufenden Karte. Die LINETRANSLATECAPS-Struktur kann ein Array von LINECARDENTRY-Strukturen enthalten.

Syntax

typedef struct linecardentry_tag {
  DWORD dwPermanentCardID;
  DWORD dwCardNameSize;
  DWORD dwCardNameOffset;
  DWORD dwCardNumberDigits;
  DWORD dwSameAreaRuleSize;
  DWORD dwSameAreaRuleOffset;
  DWORD dwLongDistanceRuleSize;
  DWORD dwLongDistanceRuleOffset;
  DWORD dwInternationalRuleSize;
  DWORD dwInternationalRuleOffset;
  DWORD dwOptions;
} LINECARDENTRY, *LPLINECARDENTRY;

Member

dwPermanentCardID

Permanenter Bezeichner, der die Karte identifiziert.

dwCardNameSize

Größe der Karte Namenszeichenfolge einschließlich NULL-Abschlusszeichen in Bytes.

dwCardNameOffset

Offset vom Anfang der -Struktur zu einer null-endenden Zeichenfolge, die die Karte benutzerfreundlich beschreibt. Die Größe des Felds wird durch dwCardNameSize angegeben.

dwCardNumberDigits

Anzahl der Ziffern in der vorhandenen Karte Zahl. Die Karte Nummer selbst wird aus Sicherheitsgründen nicht zurückgegeben (sie wird von TAPI in verschlüsselter Form gespeichert). Die Anwendung kann dies verwenden, um Füllbytes in ein Textsteuerelement im "Kennwort"-Modus einzufügen, um anzuzeigen, dass eine Zahl vorhanden ist.

dwSameAreaRuleSize

Größe der Wählregel für den gleichen Bereich, einschließlich des NULL-Abschlusszeichens in Byte.

dwSameAreaRuleOffset

Offset vom Anfang der LINETRANSLATECAPS-Struktur bis zur Wählregel, die für Anrufe von Nummern in derselben Ortsvorwahl definiert ist. Die Regel ist eine NULL-endende Zeichenfolge. Die Größe des Felds wird durch dwSameAreaRuleSize angegeben.

dwLongDistanceRuleSize

Größe der Wählregel für lange Entfernungen einschließlich des NULL-Abschlusszeichens in Byte.

dwLongDistanceRuleOffset

Offset vom Anfang der Struktur bis zur Wählregel, die für Anrufe an Nummern in den anderen Bereichen desselben Landes/derselben Region definiert ist. Die Regel ist eine NULL-endende Zeichenfolge. Die Größe des Felds wird von dwLongDistanceRuleSize angegeben.

dwInternationalRuleSize

Größe der internationalen Wählregel einschließlich des NULL-Abschlusszeichens in Byte.

dwInternationalRuleOffset

Offset vom Anfang der Struktur bis zur Wählregel, die für Anrufe an Nummern in anderen Ländern/Regionen definiert ist. Die Regel ist eine NULL-endende Zeichenfolge. Die Größe des Felds wird von dwInternationalRuleSize angegeben.

dwOptions

Gibt weitere Einstellungen an, die diesem aufrufenden Karte zugeordnet sind, wobei die LINECARDOPTION_ Konstanten verwendet werden.

Hinweise

Ältere Anwendungen werden ohne Kenntnis dieser neuen Felder kompiliert und verwenden einen SIZEOF(LINECARDENTRY), der kleiner als die neue Größe ist. Da es sich um ein Array im variablen Teil einer LINETRANSLATECAPS-Struktur handelt, ist es zwingend erforderlich, dass ältere Anwendungen LINECARDENTRY-Strukturen in dem zuvor erwarteten Format erhalten, 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 die LINECARDENTRY-Felder und die Größe verwenden, die der angegebenen API-Version entsprechen, wenn die LINETRANSLATECAPS-Struktur erstellt wird, die an die Anwendung zurückgegeben werden soll.

Diese Struktur kann nicht erweitert werden.

Anforderungen

Weitere Informationen

LINETRANSLATECAPS

lineGetTranslateCaps