📄 struc2_3lo2.htm

📁 TAPI Exampple
💻 HTM
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML DIR="LTR"><HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso8859-1">
</HEAD>
<TITLE>LINETRANSLATEOUTPUT</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINETRANSLATEOUTPUT">
<META NAME="MS-HAID" CONTENT="_tapi2_linetranslateoutput_str">
</HEAD>
<BODY TOPMARGIN="0">

<!--TOOLBAR_START-->
<!--TOOLBAR_EXEMPT-->
<!--TOOLBAR_END-->
<!--SYNC_START-->
<script language="JavaScript" src='/library/synch.js'></script>
<!--SYNC_END-->

<H1><A NAME="_tapi2_linetranslateoutput_str"></A>LINETRANSLATEOUTPUT</H1>

<P>The <B>LINETRANSLATEOUTPUT</B> structure describes the result of an address translation. The <A HREF="func2_69mb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_69mb.htm"><B>lineTranslateAddress</B></A> function uses this structure.</P>

<PRE class=syntax>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, FAR *LPLINETRANSLATEOUTPUT; </PRE>

<H4>Members</H4>

<DL>
<DT><B>dwTotalSize</B> </DT>

<DD>The total size, in bytes, allocated to this data structure. </DD>

<DT><B>dwNeededSize</B> </DT>

<DD>The size, in bytes, for this data structure that is needed to hold all the returned information. </DD>

<DT><B>dwUsedSize</B> </DT>

<DD>The size, in bytes, of the portion of this data structure that contains useful information. </DD>

<DT><B>dwDialableStringSize</B> </DT>

<DT><B>dwDialableStringOffset</B> </DT>

<DD>Contains the translated output that can be passed to the <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A>, <A HREF="func1_0p0s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0p0s.htm"><B>lineDial</B></A>, or other function requiring a dialable string. The output is always a null-terminated string (NULL is included in the count in <B>dwDialableStringSize</B>). Ancillary fields such as name and subaddress are included in this output string if they were in the input string. This string may contain private information such as calling card numbers. It should not be displayed to the user, to prevent inadvertent visibility to unauthorized persons. </DD>

<DT><B>dwDisplayableStringSize</B> </DT>

<DT><B>dwDisplayableStringOffset</B> </DT>

<DD>Contains the translated output that can be displayed to the user for confirmation. It is identical to <B>DialableString</B>, except that calling card digits are replaced with the "friendly name" of the card enclosed within bracket characters (for example, "[AT&amp;T Card]"), and ancillary fields such as name and subaddress are removed. It should normally be safe to display this string in call-status dialog boxes without exposing private information to unauthorized persons. This information is also appropriate to include in call logs. </DD>

<DT><B>dwCurrentCountry</B> </DT>

<DD>Contains the country code configured in <B>CurrentLocation</B>. This value may be used to control the display by the application of certain user interface elements, for local call progress tone detection, and for other purposes. </DD>

<DT><B>dwDestCountry</B> </DT>

<DD>Contains the destination country code of the translated address. This value may be passed to the <I>dwCountryCode</I> parameter of <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A> and other dialing functions (so that the call progress tones of the destination country/region such as a busy signal are properly detected). This field is set to zero if the destination address passed to <A HREF="func2_69mb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_69mb.htm"><B>lineTranslateAddress</B></A> is not in canonical format. </DD>

<DT><B>dwTranslateResults</B> </DT>

<DD>Indicates the information derived from the translation process, which may assist the application in presenting user-interface elements. This field uses one of the <A HREF="constnts_2e43.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_2e43.htm">LINETRANSLATERESULT_ Constants</A>.
</DD>
</DL>

<H4>Remarks</H4>

<P>This structure may not be extended.</P>

<H4><A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm  \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上.  \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm'" tppabs="http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm">Requirements</A> </H4>

<P><B>&nbsp;&nbsp;Windows NT/2000: </B>Requires Windows NT 4.0 SP3 or later.<BR>
<B>&nbsp;&nbsp;Windows 95/98: </B>Requires Windows 95 or later.<BR>
<B>&nbsp;&nbsp;Version: </B>Requires TAPI 1.4 or later.<BR>
<B>&nbsp;&nbsp;Header: </B>Declared in Tapi.h.</P>

<H4>See Also</H4>

<P><A HREF="func1_0p0s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0p0s.htm"><B>lineDial</B></A>, <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A>, <A HREF="func2_69mb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_69mb.htm"><B>lineTranslateAddress</B></A> </P>
<DIV CLASS="footer">Built on Monday, August 14, 2000</DIV>
<!--FOOTER_START-->
<DIV CLASS="footer" STYLE="color:#000000;font-size:90%;">
<A HREF="mailto:sdkfdbk@microsoft.com">Send feedback</A> to the Platform SDK.</P>
<P><A HREF="javascript:if(confirm('http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm  \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上.  \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm'" tppabs="http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm" TARGET="_top">&#169; 1999 Microsoft Corporation. All rights reserved. Terms of use.</A></P>
</DIV>
<!--FOOTER_END-->

</BODY>
</HTML>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -