|
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
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Unix Manual Pages
|
