LINECARDENTRY

The LINECARDENTRY structure describes a calling card.

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, FAR *LPLINECARDENTRY;

Members

dwPermanentCardID

The permanent ID that identifies the card.

dwCardNameSize

dwCardNameOffset

Contains a NULL-terminated ASCII string (size includes the NULL) that describes the card in a user-friendly manner.

dwCardNumberDigits

The number of digits in the existing card number. The card number itself is not returned for security reasons (it is stored in scrambled form by TAPI). The application can use this to insert filler bytes into a text control in "password" mode to show that a number exists.

dwSameAreaRuleSize

dwSameAreaRuleOffset

The offset in bytes from the beginning of the LINETRANSLATECAPS structure and the total number of bytes in the dialing rule defined for calls to numbers in the same area code. The rule is a null-terminated ASCII string.

dwLongDistanceRuleSize

dwLongDistanceRuleOffset

The offset in bytes from the beginning of the LINETRANSLATECAPS structure and the total number of bytes in the dialing rule defined for calls to numbers in the other areas in the same country. The rule is a null-terminated ASCII string.

dwInternationalRuleSize

dwInternationalRuleOffset

The offset in bytes from the beginning of the LINETRANSLATECAPS structure and the total number of bytes in the dialing rule defined for calls to numbers in other countries. The rule is a null-terminated ASCII string.

dwOptions

Indicates other settings associated with this calling card, using the LINECARDOPTION_ set of constants.

Remarks

Older applications will have been compiled without knowledge of these new fields, and using a SIZEOF LINECARDENTRY smaller than the new size. Because this is an array in the variable portion of a LINETRANSLATECAPS structure, it is imperative that older applications receive LINECARDENTRY structures in the format they previously expected, or they will not be able to index properly through the array. The application passes in a dwAPIVersion parameter with the lineGetTranslateCaps function, which can be used for guidance by TAPI in handling this situation. lineGetTranslateCaps should use the LINECARDENTRY fields and size that match the indicated API version, when building the LINETRANSLATECAPS structure to be returned to the application.

No extensions.

See Also

lineGetTranslateCaps, LINETRANSLATECAPS

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database