lineDial-Funktion (tapi.h)

Artikel
08/26/2023

Die lineDial-Funktion wählt die angegebene wählbare Nummer für den angegebenen Anruf.

Syntax

LONG lineDial(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Parameter

hCall

Verarbeiten Sie den Anruf, für den eine Nummer gewählt werden soll. Die Anwendung muss ein Besitzer des Anrufs sein. Der Aufrufstatus von hCall kann ein beliebiger Zustand sein, außer leer undgetrennt.

lpszDestAddress

Ziel, das im Standardformat für wählbare Nummern gewählt werden soll.

dwCountryCode

Landes- oder Regionscode des Ziels. Dies wird von der -Implementierung verwendet, um die Aufrufstatusprotokolle für die Zieladresse auszuwählen. Wenn der Wert 0 angegeben wird, wird ein vom Dienstanbieter definiertes Standardprotokoll für den Anrufstatus verwendet.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_ADDRESSBLOCKED, LINEERR_INVALPOINTER, LINEERR_DIALBILLING, LINEERR_NOMEM, LINEERR_DIALDIALTONE, LINEERR_NOTOWNER, LINEERR_DIALPROMPT, LINEERR_OPERATIONFAILED, LINEERR_DIALQUIET, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE.

Hinweise

Wenn LINEERR_INVALADDRESS zurückgegeben wird, wurde keine Wählfunktion durchgeführt. Wenn LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE oder LINEERR_DIALPROMPT zurückgegeben wird, ist keine der aktionen aufgetreten, die anderweitig von lineDial ausgeführt werden. Beispielsweise wurde keine der wählbaren Adressen vor dem verletzenden Zeichen gewählt, kein Hookswitch-Zustand hat sich geändert usw.

Die lineDial-Funktion wird für die Wählfunktion eines vorhandenen Anrufs verwendet. Wenn beispielsweise ein Anruf für die Übertragung oder Konferenz eingerichtet wurde, wird automatisch ein Beratungsgespräch zugeordnet, und die lineDial-Funktion wird verwendet, um die Wählfunktion dieses Beratungsgesprächs durchzuführen. Die lineDial-Funktion kann im Rahmen einer mehrstufigen Wählfunktion mehrmals aufgerufen werden, wenn die Gerätefunktionen der Leitung dies zulassen. Außerdem können mehrere Adressen in einer einzelnen Wählzeichenfolge bereitgestellt werden, die durch CRLF getrennt ist. Dienstanbieter, die inverses Multiplexing bereitstellen, können einzelne physische Aufrufe mit jeder der Adressen einrichten und ein einzelnes Aufrufhandle an das Aggregat aller Aufrufe an die Anwendung zurückgeben. Alle Adressen würden denselben Länder- oder Regionscode verwenden.

Die Einwahl gilt als abgeschlossen, nachdem die Adresse an den Dienstanbieter übergeben wurde; nicht, nachdem der Anruf endgültig verbunden wurde. Dienstanbieter, die inverses Multiplexing bereitstellen, können die gleichzeitige Bereitstellung mehrerer Adressen ermöglichen. Der Dienstanbieter sendet LINE_CALLSTATE Nachrichten an die Anwendung, um sie über den Fortschritt des Aufrufs zu informieren. Um einen Aufrufversuch abzubrechen, während ein Aufruf eingerichtet wird, sollte die aufrufende Anwendung lineDrop verwenden.

Eine Anwendung kann den lpszDestAddress-Parameter der lineDial-Funktion auf die Adresse einer leeren Zeichenfolge festlegen, um anzugeben, dass die Wählvorgänge abgeschlossen sind, aber nur, wenn bei den vorherigen Aufrufen der Funktionen lineMakeCall und lineDial die von lpszDestAddress angegebenen Zeichenfolgen mit Semikolons beendet wurden.

Die lineDial-Funktion kann auch bei partieller Wählfunktion verwendet werden. Um einen Anruf mit partieller Wählfunktion zu initiieren, ruft die Anwendung lineMakeCall auf und gibt eine teilwählende Zeichenfolge an. Eine partielle Wählzeichenfolge ist eine beliebige Wählzeichenfolge, die durch ein Semikolon beendet wird. Der Aufruf wechselt in der Regel zu LINECALLSTATE_DIALING danach kann lineDial aufgerufen werden, um weitere Wählzeichenfolgen anzugeben, die jeweils durch ein Semikolon beendet werden. Die Wählfunktion wird durch Aufrufen von lineDial mit einer Wählzeichenfolge abgeschlossen, die nicht mit einem Semikolon (z. B. einer leeren Zeichenfolge) beendet wird. Diese Technik ermöglicht Es Anwendungen, interaktive Teilwählvorgänge mit dem Benutzer durchzuführen oder eine komplexere Wählfunktion zu ermöglichen, als ein TSP möglicherweise möglich ist.

Wenn eine NULL-Zielzeichenfolge oder eine leere Zeichenfolge, die mit einem Semikolon (";") beendet wird, in lineMakeCall eingegeben wird, wechselt die Anwendung in LINE_CALLSTATE_DIALTONE. Die lineDial-Funktion kann in diesem Zustand aufgerufen werden, um eine einzelne Wählzeichenfolge oder mehrere partielle Wählzeichenfolgen einzugeben, die jeweils durch ein Semikolon getrennt sind. Die Anwendung wechselt in den LINECALLSTATE_DIALING Zustand, nachdem die erste Ziffer eingegeben wurde.

Hinweis Die lineDial-Funktion ist nur verfügbar, wenn sich ein Aufruf in LINECALLSTATE_DIALING oder LINE_CALLSTATE_DIALTONE befindet. Wenn DTMF benötigt wird, während ein Anruf verbunden ist (LINECALLSTATE_CONNECTED), verwenden Sie lineGenerateDigits.