TapiDial

obj -> TapiDial(alpha1[, int2[, int3]]) : int

Nummer wählen

Details

• obj: Deskriptor des TAPI-Gerätetreibers
• alpha1: Wählstring
• int2:
  • Optionen (optional):
  • 0
  • _TapiAsyncDial
  • _TapiReturnCallID
  • _TapiRawDial
• int3: Timeout beim synchronen Wählen in Millisekunden (optional)
• Resultat: int _ErrOk , resultierende Call-ID oder Fehlerwert
• Siehe: Verwandte Befehle , TapiOpen () , Blog

Mit diesem Befehl kann über ein TAPI-Gerät eine Nummer gewählt werden. In (obj) muss der Deskriptor des TAPI-Gerätes , der zuvor mit dem Befehl CteRead () aus der Liste der TAPI-Geräte ermittelt wurde, übergeben werden. Die Zeichenkette mit der zu wählenden Nummer wird in (alpha1) übergeben.

Das Format und die zulässigen Zeichen in diesem Wählstring sind von dem verwendeten Gerätetreiber abhängig.

Über den Parameter (int2) können zusätzliche Optionen definiert werden. Standardmäßig wird synchron gewählt. Dabei kann in (int3) ein Timeout angegeben werden. Ist kein Timeout angegeben, wird bis zu 60 Sekunden gewartet. Mit _TapiAsyncDial in (int2) wird asynchron gewählt. Beim asynchronen Wählen werden Angaben in (int3) ignoriert. Mit der Option _TapiReturnCallID wird zusätzlich zum asynchronen Wählen die resultierende Call-ID zurückgegeben. Wird in (int2) _TapiRawDial angegeben, wird der Wählstring durch den Tapi-Treiber nicht für das Tapi-Device aufbereitet, sondern unverändert zum Wählen benutzt.

Beim asynchronen Wählen kann über das Ereignis EvtTapi festgestellt werden, ob eine Verbindung zustande gekommen ist oder nicht. Die Abfrage des Verbindungsfehlers kann über den Aufruf TapiCall (..., _TapiCallOpDisconnectMode ) erfolgen.

Als Rückgabewerte können neben _ErrOk die im Abschnitt Konstanten für Fehler von der TAPI-Schnittstelle beschriebenen Konstanten zurückgegeben werden. Bei der Option _TapiReturnCallID ist das Resultat im erfolgreichen Fall die resultierende Call-ID.

Bei der Programmierung sollte ein asynchroner Dialog verwendet werden. Der Befehl kann nicht abgebrochen werden und bis zu Ende des Timeouts dauern, bis er vom TAPI-Treiber zurückkehrt.

Wird ein TapiDial () durchgeführt und anschliessend ein TapiDial () mit einem anderen TAPI-Gerät durchgeführt, wird das aktuelle TAPI-Gerät geschlossen.

Mögliche Laufzeitfehler:

• _ErrValueInvalid: In (int2) wurde ein anderer Wert als 0 oder eine ungültige Konstante angegeben.