LINELOCATIONENTRY 结构 (tapi.h)

LINELOCATIONENTRY 结构描述用于提供地址转换上下文的位置。 LINETRANSLATECAPS 结构可以包含 LINELOCATIONENTRY 结构的数组。

语法

typedef struct linelocationentry_tag {
  DWORD dwPermanentLocationID;
  DWORD dwLocationNameSize;
  DWORD dwLocationNameOffset;
  DWORD dwCountryCode;
  DWORD dwCityCodeSize;
  DWORD dwCityCodeOffset;
  DWORD dwPreferredCardID;
  DWORD dwLocalAccessCodeSize;
  DWORD dwLocalAccessCodeOffset;
  DWORD dwLongDistanceAccessCodeSize;
  DWORD dwLongDistanceAccessCodeOffset;
  DWORD dwTollPrefixListSize;
  DWORD dwTollPrefixListOffset;
  DWORD dwCountryID;
  DWORD dwOptions;
  DWORD dwCancelCallWaitingSize;
  DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;

成员

dwPermanentLocationID

永久。标识位置。

dwLocationNameSize

以字符为单位，以 null 结尾的位置名称字符串（包括 null 终止字符）的大小。

dwLocationNameOffset

在 dwLocationNameSize 中指定的偏移大小，从包含此项的 LINETRANSLATECAPS 结构的开头 () 到以用户友好方式描述位置的 以 null 结尾的字符串。

dwCountryCode

位置的国家或地区代码。

dwCityCodeSize

null 结尾的城市代码字符串的大小（以字符为单位），包括 null 终止字符。

dwCityCodeOffset

在 dwCityCodeSize 中指定的偏移量，从此结构的开头到指定与位置关联的城市/区号的 以 null 结尾的字符串。应用程序可以在输入电话号码时将此信息与国家或地区代码一起用于用户“默认”输入字段，以鼓励输入正确的规范号码。

dwPreferredCardID

从此位置拨号时首选呼叫卡。

dwLocalAccessCodeSize

本地访问代码字符串的大小（以字节为单位），包括 null 终止符。

dwLocalAccessCodeOffset

在 dwLocalAccessCodeSize 中指定的偏移大小，从 LINETRANSLATECAPS 结构的开头到 以 null 结尾的字符串，其中包含在调用本地呼叫区域中的地址之前要拨号的访问代码。

dwLongDistanceAccessCodeSize

长距离访问代码的大小（以字节为单位），包括 null 终止符。

dwLongDistanceAccessCodeOffset

在 dwLongDistanceAccessCodeSize 中指定的偏移大小，从 LINETRANSLATECAPS 结构的开头到包含访问代码的 以 null 结尾的字符串，然后再调用本地呼叫区域外部的地址。

dwTollPrefixListSize

收费前缀的大小（以字节为单位），包括 null 终止符。

dwTollPrefixListOffset

在 dwTollPrefixListSize 中指定的偏移大小，从 LINETRANSLATECAPS 结构的开头到包含位置的收费前缀列表的 以 null 结尾的字符串。字符串仅包含由数字“0”到“9”组成的前缀，彼此之间用单个 “、” (逗号) 字符分隔。

dwCountryID

为位置选择的国家/地区的标识符。这可以与 lineGetCountry 函数一起使用，以获取有关特定国家/地区的其他信息，例如国家/地区名称 (dwCountryCode 成员不能用于此目的，因为国家/地区代码不是唯一) 。

dwOptions

此位置有效的选项，其值取自 LINELOCATIONOPTION_常量。

dwCancelCallWaitingSize

取消呼叫等待字符串的大小（以字节为单位）。

dwCancelCallWaitingOffset

在 dwCancelCallWaitingSize 中指定的偏移大小，从 LINETRANSLATECAPS 结构的开头到包含拨号数字和修饰符的以 null 结尾的字符串，当应用程序在 lineTranslateAddress 的 dwTranslateOptions 参数中设置LINETRANSLATEOPTION_CANCELCALLWAITING位时，在脉冲/音调字符) 之后，应作为可拨号 (字符串前缀的拨号数字和修饰符字符。如果未定义前缀， dwCancelCallWaitingSize 可能设置为零或 1，dwCancelCallWaitingOffset 可能指向空字符串 (单个 NULL 字节) 。

注解

无法扩展此结构。

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