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
| Anforderung | Wert |
|---|---|
| Header | tapi.h |