Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Differences between tapiDial and tapiLineDial
  • Limitation
  • Required configuration
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Dials a phone number for a voice line.
WINDEV Remark: By default, the device used is the first TAPI 3.1-compatible device found. A specific device can be selected by tapiDevice. In this case, this specific device will be used.
WINDEV PABX application: With a PABX application, each line appears as a device. Therefore, to dial on a phone line, you must:
  1. Choose the current phone line (tapiDevice).
  2. Number (tapiDial).
To do so, use the tapiLineDial function.
Remark: Depending on the operating system and on the modem driver, a window for call management may be displayed when using tapiDial. This window is used to automatically end the current call.
IF tapiDial(SAI_NuméroTéléphone, "TestEtatLigne") = True THEN
Info("Cliquez sur OK pour raccrocher")
PROCÉDURE 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")
<Result> = tapiDial(<Number to dial> [, <WLanguage procedure> [, <Duration> [, <Custom parameter>]]])
<Result>: Boolean
  • True if the line is opened: you can pick up the receiver and talk,
  • False otherwise. To get the details of the error, use tapiError.
<Number to dial>: Character string
Phone number to dial. To specify a prefix (0 for an external line for example), use a comma in the number. For example: "0,0467789066".
<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 procedure parameter (<Line status>) is an integer that can take the following values:
tapiLineBusyThe line is currently busy.
tapiLineConnectedThe line is connected.
tapiLineDialingDialing in progress.
Remark: If TAPI 3.1 technology is used, this constant is no longer returned.
tapiLineDialToneThe line gets a dial tone.
tapiLineDisconnectedThe correspondent has hung up.
tapiLineProceedingThe call is dialed: searching for the correspondent.
tapiLineRingBackRinging in progress.
The second procedure parameter (<Parameter>) is the custom parameter passed to tapiDial.
Caution: This procedure must contain no call to the debugger (no breakpoint, no STOP keyword, no auto-stop expression, etc.).
<Duration>: Optional integer or optional Duration
Maximum wait duration (in seconds). When this timeout is exceeded, the function assumes that there is no response (nobody picked up).
This parameter can correspond to:
  • an integer corresponding to the number of seconds,
  • a Duration variable,
  • Versions 23 and later
    the duration in a readable format (e.g., 1 s or 10 ms).
    New in version 23
    the duration in a readable format (e.g., 1 s or 10 ms).
    the duration in a readable format (e.g., 1 s or 10 ms).
<Custom parameter>: Any type, optional
Parameter passed to the WLanguage procedure.

Differences between tapiDial and tapiLineDial

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


tapiDial 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: wd270com.dll
Minimum version required
  • Version 9
This page is also available for…
Click [Add] to post a comment