LINETRANSLATERESULT_ Constants

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

LINETRANSLATERESULT_CANONICAL

Indicates that the input string was in valid canonical format.

LINETRANSLATERESULT_DIALBILLING

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 "?".

LINETRANSLATERESULT_DIALQUIET

Indicates that the returned address contain a "@".

LINETRANSLATERESULT_INTERNATIONAL

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

LINETRANSLATERESULT_INTOLLLIST

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

LINETRANSLATERESULT_LOCAL

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

LINETRANSLATERESULT_LONGDISTANCE

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

LINETRANSLATERESULT_NOTINTOLLLIST

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

LINETRANSLATERESULT_NOTRANSLATION

Indicates that address translation is not available. This element is exposed only to applications that negotiate a TAPI version of 3.0 or higher.

LINETRANSLATERESULT_VOICEDETECT

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

Note

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

No extensibility. All 32 bits are reserved.

Requirements