public TapiCall Dial(
	string number,
	bool useDialingRules,
	TapiMediaMode mediaMode,
	TapiAddress address
)

Public Function Dial ( 
	number As String,
	useDialingRules As Boolean,
	mediaMode As TapiMediaMode,
	address As TapiAddress
) As TapiCall

public:
TapiCall^ Dial(
	String^ number, 
	bool useDialingRules, 
	TapiMediaMode mediaMode, 
	TapiAddress^ address
)

Parameters

number

Type: SystemString
A string that contains a number to dial.

useDialingRules

Type: SystemBoolean
Indicates if the dialing rules specified in the Control Panel should be applied.

mediaMode

Type: Traysoft.AddTapiTapiMediaMode
Expected media type of the call.

address

Type: Traysoft.AddTapiTapiAddress
Originating address for the call.

Return Value

In order to dial an outgoing call, the line must be opened using Open(Boolean, TapiCallHandler) method first. The application can open the line for outgoing calls by passing false as the first parameter of Open(Boolean, TapiCallHandler). Also, outgoing calls can be dialed on the line open for incoming calls.

After an outgoing call is connected, AddTapi.NET fires CallConnected event and executes TapiCallHandler method passed as the second parameter of Open(Boolean, TapiCallHandler). If outgoing call cannot be completed because there is no dailtone, a busy signal was detected or if the called party did not answer within the time interval set in NoAnswerTimeout property, AddTapi.NET fires CallDisconnected event. The application can find out the reason for disconnect by examining the DisconnectMode property of the disconnected call. After CallDisconnected event occurs, another outgoing call can be placed on the same line.

When useDialingRules parameter is false, a number to dial is passed directly to the telephony hardware without any translation. In this case the number parameter follows a standard dialable number format. A dialable number can contain the following DTMF or pulse digits: '0'-'9', 'A'-'D', '*' and '#'. A dialable number can also contain the following modifiers (if supported by the telephony hardware):

When useDialingRules parameter is true, a number to dial is translated using dialing rules specified in the Telephony applet in the Control Panel. In this case the number parameter should follow canonical format. A canonical phone number is a text string with the following structure:

+ CountryCode Space [(AreaCode) Space] SubscriberNumber

Plus sign (hex 2B) indicates that the number that follows it uses the canonical format. The plus sign is followed by the variably sized country code (CountryCode element) without any spaces between the plus sign and the country code. CountryCode is followed by exactly one space character (hex 20). AreaCode is the area code part of the number and is optional. If the area code is present, it must be preceded by exactly one left parenthesis character (hex 28), and be followed by exactly one right parenthesis character (hex 29) and one space character (hex 20). SubscriberNumber may include digits '0' - '9', 'A' - 'D' , '*' and '#'. Other dial control characters described above in the dialable number format are also allowed. The subscriber number should not contain the left parenthesis or right parenthesis character (which are used only to delimit the area code). The following nondigit characters in the subscriber number are allowed: spaces, periods '.' and dashes '-'. They are used for display purposes and are ignored. For example, the canonical representation of the US phone number 555-123-4567 would be:

+1 (555) 123-4567

The mediaMode parameter indicates what media type is expected on the call. The application should specify TapiMediaMode.AutomatedVoice media mode in order to use voice functionality such as playing wave files using Play(String) and speaking to the caller using Speak(String).

The address parameter allows to select originating address for lines that have multiple associated addresses. This parameter must contain one of the addresses listed in the Addresses collection.

Reference