TSPI_lineDial-Funktion (tspi.h)

Artikel
03/03/2024

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

Syntax

LONG TSPIAPI TSPI_lineDial(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

Parameter

dwRequestID

Der Bezeichner der asynchronen Anforderung.

hdCall

Das Handle des Dienstanbieters für den zu wählenden Anruf. Der Aufrufstatus von hdCall kann ein beliebiger Zustand sein, außer im Leerlauf und getrennt.

lpszDestAddress

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die das Ziel angibt, das im Standardformat für wählbare Nummern gewählt werden soll.

dwCountryCode

Der Länder- oder Regionscode des Ziels. Die Implementierung verwendet dies, um die Aufrufstatusprotokolle für die Zieladresse auszuwählen. Wenn der Wert 0 angegeben wird, wird ein vom Dienstanbieter definiertes Standardprotokoll für den Aufrufstatus verwendet. TAPI überprüft diesen Parameter nicht, wenn diese Funktion aufgerufen wird.

Rückgabewert

Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE, LINEERR_DIALBILLING, LINEERR_INVALCALLSTATE, LINEERR_DIALQUIET, LINEERR_ADDRESSBLOCKED, LINEERR_DIALDIALTONE, LINEERR_NOMEM, LINEERR_DIALPROMPT, LINEERR_OPERATIONUNAVAIL.

Hinweise

Der Dienstanbieter gibt LINEERR_INVALCALLSTATE zurück, wenn der aktuelle Zustand des Anrufs keine Wählfunktion zulässt.

Der Dienstanbieter führt keine Wählfunktion durch, wenn er LINEERR_INVALADDRESS zurückgibt.

Wenn der Dienstanbieter LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE oder LINEERR_DIALPROMPT zurückgibt, sollte er keine der Aktionen ausführen, die anderweitig von TSPI_lineDial ausgeführt werden (z. B. keine teilweise Wählvorgänge und kein Ausrufen). Dies liegt daran, dass der Dienstanbieter die Nummer vorab auf nicht unterstützte Zeichen überprüfen sollte.

TSPI_lineDial wird für die Wählfunktion eines vorhandenen Anrufs verwendet. Beispielsweise werden Von TSPI_lineMakeCall zurückgegebene Aufrufhandles mit NULL als lpszDestAddress oder mit ";" endend, von TSPI_lineSetupTransfer oder TSPI_lineSetupConference zurückgegebene Aufrufhandles. TSPI_lineDial kann bei mehrstufigen Wählvorgängen mehrmals während der Wählvorgänge aufgerufen werden, wenn die Gerätefunktionen der Leitung dies zulassen.

Wenn die Zeichenfolge, auf die der lpszDestAddress-Parameter im vorherigen Aufruf der TSPI_lineMakeCall - oder TSPI_lineDial-Funktion verweist, mit einem Semikolon beendet wird, gibt eine leere Zeichenfolge im aktuellen Aufruf von TSPI_lineDial an, dass die Wählvorgänge abgeschlossen sind.

Mehrere Adressen können in einer einzelnen durch CRLF getrennten Wählzeichenfolge bereitgestellt werden. 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 Wählverbindung gilt als abgeschlossen, nachdem die Adresse vom Dienstanbieter akzeptiert wurde, nicht nach der endgültigen Verbindung des Anrufs. Dienstanbieter, die inverses Multiplexing bereitstellen, können es ermöglichen, dass mehrere Adressen gleichzeitig bereitgestellt werden. Der Dienstanbieter muss LINE_CALLSTATE Nachrichten an TAPI senden, um sie über den Fortschritt des Anrufs zu informieren.