TAPIEx.NET Component Documentation

TranslateAddress  Method

Description

The TranslateAddress method translates the specified address into another format. ( Translate Canonical Addresses to Dialable Addresses)

[Visual Basic]
Function TranslateAddress( sAddressToTranslate As String, PermanentCardID As Long, TranslateOptions As LINETRANSLATEOPTION) As IAddressTranslationInfo
[C#]
public AddressTranslationInfo TranslateAddress(
System.String AddressToTranslate,
System.Int32 PermanentCardID,
TAPIEx.LINETRANSLATEOPTION TranslateOptions )

Parameters

sAddressToTranslate
string containing the address from which the information is to be extracted for translation. Must be in either the canonical address format, or an arbitrary string of dialable digits (non-canonical). This parameter must not be NULL. If the AddressIn contains a subaddress or name field, or additional addresses separated from the first address by CR and LF characters, only the first address is translated.
PermanentCardID
The credit card to be used for dialing. This parameter is only valid if the TRANSLATEOPTION_CARDOVERRIDE bit is set in TranslateOptions. Use TAPIExCtl.CallingCards enumerate the calling cards.
TranslateOptions
The associated operations to be performed prior to the translation of the address into a dialable string. This parameter uses one of the LINETRANSLATEOPTION Constants.

Return values

Return the newly created IAddressTranslationInfo class.

Remarks

The TranslateAddress method translates the telephone number using the dialing rules set in the Windows Dialing Properties for the currently selected Location. (Use TAPIExCtl.Locations(0) return the current location)

See Also

IAddressTranslationInfo, Dialable Addresses , Canonical Addresses , TranslateDialog

Support editions