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