tapiLineDial (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / Phone functions

Differences between tapiDial and tapiLineDial
Limitation
Required configuration

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

tapiLineDial (Function)

In french: telComposeLigne

Dials a phone number for a voice line and chooses the device to use.

PABX application: In a PABX application, each line appears as a device.. Therefore, to dial on a phone line, you must:

Choose the current phone line (tapiDevice).
Number (tapiDial).

This is done by tapiLineDial.

Example

// Récupère la liste des périphériques TAPI 
sListeTAPI is string = telListePériphérique() 
// Affiche la liste dans un champ Combo 
ListAdd(COMBO_TAPI, sListeTAPI) 
... 
// Sélectionne le périphérique TAPI 
IF tapiLineDial(COMBO_TAPI[COMBO_TAPI], SAI_NuméroTéléphone, "TestEtatLigne") <> 0 THEN 
	Info("Cliquez sur OK pour raccrocher") 
	tapiHangUp() 
END

PROCEDURE TestEtatLigne(ValeurEtatLigne is int) 
SWITCH ValeurEtatLigne 
	CASE tapiLineBusy: Message("La ligne est occupée") 
	CASE tapiLineConnected: Message("OK, connecté") 
	CASE tapiLineDialing: Message("Numérotation en cours") 
	CASE tapiLineDialTone: Message("Tonalité") 
	CASE tapiLineDisconnected: Message("Le correspondant a raccroché") 
	CASE tapiLineProceeding: Message("Recherche du correspondant") 
	CASE tapiLineRingBack: Message("Sonnerie chez le correspondant") 
END

Syntax

<Result> = tapiLineDial(<Line to use> , <Number to dial> [, <WLanguage procedure> [, <Duration> [, <Custom parameter>]]])

<Result>: Integer

Identifier of call dialed.
0 if an error occurs. The error details are returned by ErrorInfo.

<Line to use>: Character string

Line or device to use.

Reminder: The list of telephony devices is known with the tapiDeviceList function.

<Number to dial>: Character string

Phone number to dial.

<WLanguage procedure>: Name of optional procedure

Name of WLanguage procedure used to manage the progress of dialing. This procedure has the following format:
PROCÉDURE <Nom de la procédure>(<Etat de la ligne>, <Paramètre>)

The first parameter of the procedure (<Line status>) is an integer that can take the following values:
tapiLineBusy The line is currently busy.
tapiLineConnected The line is connected.
tapiLineDialing Dialing in progress.
Note: If TAPI 3.1 technology is used, this constant is no longer returned.
tapiLineDialTone The line gets a dial tone.
tapiLineDisconnected The correspondent has hung up.
tapiLineProceeding The call is dialed: looking for the person called.
tapiLineRingBack Ringing in progress.
The second procedure parameter (<Parameter>) is the custom parameter passed to tapiLineDial.
Warning: this procedure must not contain any calls to the debugger (no breakpoint, no STOP keyword, no auto-stop expression, ...).

<Duration>: Optional integer or optional Duration

Maximum wait duration (in seconds). Beyond this duration, the function assumes there is no response (no one picked up). This parameter can correspond to:
an integer corresponding to the number of seconds,
a Duration variable,
the duration in a readable format (e.g., 1 s or 10 ms).
This parameter corresponds to 15 seconds by default.

<Custom parameter>: Any type, optional

Parameter passed to the WLanguage procedure.

Remarks

Differences between tapiDial and tapiLineDial

tapiDial is used in a context of a single outgoing call. The identifier of this call is not available.
tapiLineDial is used in a context where several simultaneous calls can be found. tapiLineDial returns the call identifier. Therefore, it can be easily handled (to transfer a call for example).

Limitation

tapiLineDial cannot be called in the procedure for call detection (defined by tapiListen).

Required configuration

Telephony functions use TAPI 2.0 technology and/or TAPI 3.1 technology. These technologies can be used on all systems.

Component: wd300com.dll