LINETRANSLATEOUTPUT 结构 (tapi.h)

LINETRANSLATEOUTPUT 结构描述地址转换的结果。 lineTranslateAddress 函数使用此结构。

语法

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

成员

dwTotalSize

分配给此数据结构的总大小（以字节为单位）。

dwNeededSize

此数据结构保存所有返回的信息所需的大小（以字节为单位）。

dwUsedSize

包含有用信息的此数据结构部分的大小（以字节为单位）。

dwDialableStringSize

调整可拨号字符串的大小（以字节为单位），包括终止 NULL。

dwDialableStringOffset

从此结构的开头到可传递给 lineMakeCall、 lineDial 或其他需要可拨号字符串的函数的已翻译输出的偏移量。 输出始终是以 null 结尾的字符串。 如果辅助字段（如 name 和 subaddress）位于输入字符串中，则此输出字符串中包含这些字段。 此字符串可能包含私人信息，例如调用卡号码。 不应向用户显示它，以防止无意中对未经授权的人员可见。 字段的大小由 dwDialableStringSize 指定。

dwDisplayableStringSize

可向用户显示的已翻译输出的大小，包括 null 终止符（以字节为单位）。

dwDisplayableStringOffset

可向用户显示以供确认的已翻译输出的偏移量。 它与 DialableString 相同，只不过调用卡数字替换为括在方括号字符中的卡友好名称， (例如“[AT&T Card]”) ，并删除了名称和子地址等辅助字段。 在 dwDisplayableStringOffset 中使用适当的消息，因为字符串可能会在“调用状态”对话框中公开显示。 此信息也适用于包含在呼叫日志中。 字段的大小由 dwDisplayableStringSize 指定。

dwCurrentCountry

在 CurrentLocation 中配置的国家或地区代码。 此值可用于通过应用某些用户界面元素来控制显示，用于本地呼叫进度音调检测，以及用于其他目的。

dwDestCountry

已翻译地址的目标国家/地区代码。 此值可以传递给 lineMakeCall 的 dwCountryCode 参数和其他拨号函数 (，以便) 正确检测到目标国家/地区的呼叫进度音（如忙信号）。 如果传递给 lineTranslateAddress 的目标地址不是规范格式，则此字段设置为零。

dwTranslateResults

从翻译过程中派生的信息，这可能有助于应用程序呈现用户界面元素。 此字段使用 LINETRANSLATERESULT_常量之一。

注解

无法扩展此结构。

要求

要求	值
Header	tapi.h

另请参阅

lineDial

lineMakeCall

lineTranslateAddress