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 identifier 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 are 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 are not 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. The lineGetTranslateCaps function 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.

QuickInfo

  Version: Use TAPI version 1.4 and later.
  Header: Declared in tapi.h.

See Also

lineGetTranslateCaps, LINETRANSLATECAPS