|
|
|
|
- Differences between tapiDial and tapiLineDial
- Limitation
- Required configuration
tapiLineDial (Function) In french: telComposeLigne Dials a phone number for a voice line and chooses the device to use. // Retrieves the list of TAPI devices sTAPIList is string = tapiDeviceList() // Displays the list in a Combo Box control ListAdd(COMBO_TAPI, sTAPIList) ... // Selects the TAPI device IF tapiLineDial(COMBO_TAPI[COMBO_TAPI], EDT_PhoneNumber, "TestLineStatus") <> 0 THEN Info("Click OK to hang up") tapiHangUp() END
PROCEDURE TestLineStatus(ValueLineStatus is int) SWITCH ValueLineStatus CASE tapiLineBusy: Message("The line is busy") CASE tapiLineConnected: Message("OK, connected") CASE tapiLineDialing: Message("Dialing in progress") CASE tapiLineDialTone: Message("Dial tone") CASE tapiLineDisconnected: Message("The correspondent has hung up") CASE tapiLineProceeding: Message("Searching for your correspondent") CASE tapiLineRingBack: Message("Ringing") 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 returned by tapiDeviceList. <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:
PROCEDURE <Procedure name>(<Line status>, <Parameter>) The first procedure parameter (<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. Remark: 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: searching for the correspondent. | tapiLineRingBack | Ringing in progress. | The second procedure parameter (<Parameter>) is the custom parameter passed to tapiLineDial.Caution: this procedure must contain no call 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.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|