?? struc2_362a.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>LINELOCATIONENTRY</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINELOCATIONENTRY">
<META NAME="MS-HAID" CONTENT="_tapi2_linelocationentry_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_linelocationentry_str"></A>LINELOCATIONENTRY</H1>
<P>The <B>LINELOCATIONENTRY</B> structure describes a location used to provide an address translation context. The <A HREF="struc2_4w36.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_4w36.htm"><B>LINETRANSLATECAPS</B></A> structure can contain an array of <B>LINELOCATIONENTRY</B> structures. </P>
<PRE class=syntax>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, FAR *LPLINELOCATIONENTRY; </PRE>
<H4>Members</H4>
<DL>
<DT><B>dwPermanentLocationID</B> </DT>
<DD>The permanent identifier that identifies the location. </DD>
<DT><B>dwLocationNameSize</B> </DT>
<DT><B>dwLocationNameOffset</B> </DT>
<DD>Contains a null-terminated string (size includes the NULL) that describes the location in a user-friendly manner. </DD>
<DT><B>dwCountryCode</B> </DT>
<DD>The country code of the location. </DD>
<DT><B>dwPreferredCardID</B> </DT>
<DD>The preferred calling card when dialing from this location. </DD>
<DT><B>dwCityCodeSize</B> </DT>
<DT><B>dwCityCodeOffset</B> </DT>
<DD>Contains a null-terminated string specifying the city/area code associated with the location (the size includes the NULL). This information, along with the country code, can be used by applications to "default" entry fields for the user when entering phone numbers, to encourage the entry of proper canonical numbers. </DD>
<DT><B>dwLocalAccessCodeSize</B> </DT>
<DT><B>dwLocalAccessCodeOffset</B> </DT>
<DD>The size, in bytes, and the offset, in bytes, from the beginning of the <A HREF="struc2_4w36.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_4w36.htm"><B>LINETRANSLATECAPS</B></A> structure of a null-terminated string containing the access code to be dialed before calls to addresses in the local calling area. </DD>
<DT><B>dwLongDistanceAccessCodeSize</B> </DT>
<DT><B>dwLongDistanceAccessCodeOffset</B> </DT>
<DD>The size, in bytes, and the offset, in bytes, from the beginning of the <B>LINETRANSLATECAPS</B> structure of a null-terminated string containing the access code to be dialed before calls to addresses outside the local calling area. </DD>
<DT><B>dwTollPrefixListSize</B> </DT>
<DT><B>dwTollPrefixListOffset</B> </DT>
<DD>The size, in bytes, and the offset, in bytes, from the beginning of the <A HREF="struc2_4w36.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_4w36.htm"><B>LINETRANSLATECAPS</B></A> structure of a null-terminated string containing the toll prefix list for the location. The string contains only prefixes consisting of the digits "0" through "9", separated from each other by a single "," (comma) character. </DD>
<DT><B>dwCountryID</B> </DT>
<DD>The country identifier of the country/region selected for the location. This can be used with the <A HREF="func1_9qex.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9qex.htm"><B>lineGetCountry</B></A> function to obtain additional information about the specific country/region, such as the country/region name (the <B>dwCountryCode</B> member cannot be used for this purpose because country codes are not unique). </DD>
<DT><B>dwOptions</B> </DT>
<DD>Indicates options in effect for this location, with values taken from the <A HREF="constnts_5ddf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_5ddf.htm">LINELOCATIONOPTION_ Constants</A>. </DD>
<DT><B>dwCancelCallWaitingSize</B> </DT>
<DT><B>dwCancelCallWaitingOffset</B> </DT>
<DD>The size, in bytes, and the offset, in bytes, from the beginning of the <A HREF="struc2_4w36.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_4w36.htm"><B>LINETRANSLATECAPS</B></A> structure of a null-terminated string containing the dial digits and modifier characters that should be prefixed to the dialable string (after the pulse/tone character) when an application sets the LINETRANSLATEOPTION_CANCELCALLWAITING bit in the <I>dwTranslateOptions</I> parameter of <A HREF="func2_69mb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_69mb.htm"><B>lineTranslateAddress</B></A>. If no prefix is defined, this may be indicated by <B>dwCancelCallWaitingSize</B> being set to zero, or by it being set to 1 and <B>dwCancelCallWaitingOffset</B> pointing to an empty string (single NULL byte).
</DD>
</DL>
<H4>Remarks</H4>
<P>This structure may not be extended.</P>
<P>Older applications are compiled without knowledge of these new fields, and using a SIZEOF LINELOCATIONENTRY smaller than the new size. Because this is an array in the variable portion of a <A HREF="struc2_4w36.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_4w36.htm"><B>LINETRANSLATECAPS</B></A> structure, it is imperative that older applications receive <B>LINELOCATIONENTRY</B> structures in the format they previously expected, or they are not able to index through the array properly. The application passes in a <I>dwAPIVersion</I> parameter with the <A HREF="func1_0sc3.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0sc3.htm"><B>lineGetTranslateCaps</B></A> function, which can be used for guidance by TAPI in handling this situation. The <B>lineGetTranslateCaps</B> function should use the <B>LINELOCATIONENTRY</B> members and size that match the indicated API version, when building the <B>LINETRANSLATECAPS</B> structure to be returned to the application. </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> Windows NT/2000: </B>Requires Windows NT 4.0 SP3 or later.<BR>
<B> Windows 95/98: </B>Requires Windows 95 or later.<BR>
<B> Version: </B>Requires TAPI 1.4 or later.<BR>
<B> Header: </B>Declared in Tapi.h.</P>
<H4>See Also</H4>
<P><A HREF="func1_9qex.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9qex.htm"><B>lineGetCountry</B></A>, <A HREF="func1_0sc3.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0sc3.htm"><B>lineGetTranslateCaps</B></A>, <A HREF="func2_69mb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_69mb.htm"><B>lineTranslateAddress</B></A>, <A HREF="struc2_4w36.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_4w36.htm"><B>LINETRANSLATECAPS</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">© 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 + -