|
LINETRANSLATEOUTPUT
The LINETRANSLATEOUTPUT structure describes the result of an address translation.
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;
Members
dwTotalSize
The total size in bytes allocated to this data structure.
dwNeededSize
The size in bytes for this data structure that is needed to hold all the
returned information.
dwUsedSize
The size in bytes of the portion of this data structure that contains useful
information.
dwDialableStringSize
dwDialableStringOffset
Contains the translated output which can be passed to the lineMakeCall, lineDial, or other function requiring a dialable string. The output is always a
null-terminated ASCII string (null is accounted for in Size). 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.
dwDisplayableStringSize
dwDisplayableStringOffset
Contains the translated output which can be displayed to the user for
confirmation. It will be identical to DialableString, except that calling card digits will be replaced with the "friendly name" of
the card enclosed within bracket characters (for example, "[AT&T Card]"), and
ancillary fields such as name and subaddress will be 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.
dwCurrentCountry
Contains the country code configured in CurrentLocation. This value may be used to control the display by the application of certain
user interface elements, local call progress tone detection, and for other
purposes.
dwDestCountry
Contains the destination country code of the translated address. This value
may be passed to the dwCountryCode parameter of lineMakeCall and other dialing functions (so that the call progress tones of the
destination country such as a busy signal will be properly detected). This field is set
to 0 if the destination address passed to lineTranslateAddress is not in canonical format.
dwTranslateResults
Indicates the information derived from the translation process, which may
assist the application in presenting user-interface elements. This field uses the
following LINETRANSLATERESULT_ constants:
LINETRANSLATERESULT_CANONICAL
Indicates that the input string was in valid canonical format.
LINETRANSLATERESULT_INTERNATIONAL
If this bit is on, the call is being treated as an international call (country
code specified in the destination address is the different from the country
code specified for the CurrentLocation).
LINETRANSLATERESULT_LONGDISTANCE
If this bit is on, the call is being treated as a long distance call (country
code specified in the destination address is the same but area code is
different from those specified for the CurrentLocation).
LINETRANSLATERESULT_LOCAL
If this bit is on, the call is being treated as a local call (country code and
area code specified in the destination address are the same as those specified
for the CurrentLocation).
LINETRANSLATERESULT_INTOLLLIST
If this bit is on, the local call is being dialed as long distance because the
country has toll calling and the prefix appears in the TollPrefixList of the CurrentLocation.
LINETRANSLATERESULT_NOTINTOLLLIST
If this bit is on, the country supports toll calling but the prefix does not
appear in the TollPrefixList, so the call is dialed as a local call. Note that if both INTOLLIST and
NOTINTOLLIST are off, the current country does not support toll prefixes, and user-interface elements related to toll prefixes
should not be presented to the user; if either such bit is on, the country does support toll lists, and the related user-interface elements should be
enabled.
LINETRANSLATERESULT_DIALBILLING
Indicates that the returned address contains a "$".
LINETRANSLATERESULT_DIALQUIET
Indicates that the returned address contains a "@".
LINETRANSLATERESULT_DIALDIALTONE
Indicates that the returned address contains a "W".
LINETRANSLATERESULT_DIALPROMPT
Indicates that the returned address contains a "?".
Remarks
No extensions.
See Also
lineDial, lineMakeCall, lineTranslateAddress
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
