LINETRANSLATERESULT (Compact 2013)

3/26/2014

These bit-flag constants describe various results of an address translation.

The following table shows the LINETRANSLATERESULT constants.

Value

Description

LINETRANSLATERESULT_CANONICAL = 0x00000001

Indicates that the input string was in valid canonical format.

LINETRANSLATERESULT_DIALBILLING = 0x00000040

Indicates that the returned address contains a "$".

LINETRANSLATERESULT_DIALDIALTONE = 0x00000100

Indicates that the returned address contains a "W".

LINETRANSLATERESULT_DIALPROMPT = 0x00000200

Indicates that the returned address contains a "?".

LINETRANSLATERESULT_DIALQUIET = 0x00000080

Indicates that the returned address contain a "@".

LINETRANSLATERESULT_INTERNATIONAL = 0x00000002

Indicates that the call is being treated as an international call. Country/region code specified in the destination address is different from the country/region code specified for the CurrentLocation.

LINETRANSLATERESULT_INTOLLLIST = 0x00000010

Indicates that the local call is being dialed as long distance because the country/region has toll calling and the prefix appears in the TollPrefixList of the CurrentLocation.

LINETRANSLATERESULT_LOCAL = 0x00000008

Indicates that the call is being treated as a local call country/region code and area code specified in the destination address are the same as those specified for the CurrentLocation.

LINETRANSLATERESULT_LONGDISTANCE = 0x00000004

Indicates that the call is being treated as a long distance call. Country/region code specified in the destination address is the same but area code is different from those specified for the CurrentLocation.

LINETRANSLATERESULT_NOTINTOLLLIST = 0x00000020

Indicates that the country/region 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/region 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/region does support toll lists, and the related user-interface elements should be enabled.

LINETRANSLATERESULT_VOICEDETECT = 0x00000400

Indicates that the returned dialable address contains a ":". This element is exposed only to applications that negotiate a TAPI version of 2.0 or later.

Ee497424.note(en-us,WinEmbedded.80).gifNote:
The ":" (colon) character will be added to the list of characters that can be embedded in a dialable string and passed into destination addresses. Attempting to pass it from an application to a line device that supports an API version earlier than 2.0 will most likely result in LINEERR_INVALADDRESS, or possibly in the character being ignored entirely. The meaning of this character is "Pause until a voice prompt is detected, then continue dialing"; it is intended for use when automatically dialing into systems that give voice prompts, such as long distance calling card processors.

Remarks

These constants cannot be extended. All 32 bits are reserved.

Requirements

Header

tapi.h

See Also

Reference

TAPI Constants