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 |