LINECARDENTRY 结构 (tapi.h)

LINECARDENTRY 结构描述调用卡。 LINETRANSLATECAPS 结构可以包含 LINECARDENTRY 结构的数组。

语法

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;

成员

dwPermanentCardID

标识卡的永久标识符。

dwCardNameSize

卡名称字符串（包括 null 终止符）的大小（以字节为单位）。

dwCardNameOffset

从结构的开头偏移到以用户友好方式描述卡的以 null 结尾的字符串。 字段的大小由 dwCardNameSize 指定。

dwCardNumberDigits

现有卡数字中的位数。 出于安全原因，不会返回卡号码本身， (TAPI) 以乱码形式存储。 应用程序可以使用此功能在“密码”模式下将填充字节插入文本控件，以显示存在数字。

dwSameAreaRuleSize

包括 null 终止符的同一区域拨号规则的大小（以字节为单位）。

dwSameAreaRuleOffset

从 LINETRANSLATECAPS 结构的开头偏移到为同一区号中的号码的呼叫定义的拨号规则。 规则是 以 null 结尾的字符串。 字段的大小由 dwSameAreaRuleSize 指定。

dwLongDistanceRuleSize

长距离拨号规则的大小（包括 null 终止符），以字节为单位。

dwLongDistanceRuleOffset

从结构开头到为同一国家/地区其他区域中号码的呼叫定义的拨号规则的偏移量。 规则是 以 null 结尾的字符串。 字段的大小由 dwLongDistanceRuleSize 指定。

dwInternationalRuleSize

国际拨号规则的大小（包括 null 终止符），以字节为单位。

dwInternationalRuleOffset

从结构的开头偏移到为其他国家/地区号码呼叫定义的拨号规则。 规则是 以 null 结尾的字符串。 字段的大小由 dwInternationalRuleSize 指定。

dwOptions

使用 LINECARDOPTION_ 常量指示与此调用卡关联的其他设置。

注解

较旧的应用程序是在不知道这些新字段的情况下编译的，并且使用 SIZEOF (LINECARDENTRY) 小于新大小。 由于这是 LINETRANSLATECAPS 结构的变量部分中的数组，因此，旧版应用程序必须以之前预期的格式接收 LINECARDENTRY 结构，否则它们无法通过数组正确编制索引。 应用程序使用 lineGetTranslateCaps 函数传入 dwAPIVersion 参数，该参数可用于 TAPI 在处理这种情况时的指导。 生成要返回到应用程序的 LINETRANSLATECAPS 结构时，lineGetTranslateCaps 函数应使用与指示的 API 版本匹配的 LINECARDENTRY 字段和大小。

此结构可能不会扩展。

要求

要求	值
Header	tapi.h

另请参阅

LINETRANSLATECAPS

lineGetTranslateCaps