lineRedirect-Funktion (tapi.h)

Artikel
08/26/2023

Die lineRedirect-Funktion leitet den angegebenen Angebotsaufruf an die angegebene Zieladresse um.

Syntax

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

Parameter

hCall

Behandeln Sie den Umleitungsaufruf. Die Anwendung muss besitzer des Aufrufs sein. Der Anrufstatus von hCall muss angeboten werden.

lpszDestAddress

Zeiger auf die Zieladresse. Dies folgt dem standardwählbaren Nummernformat.

dwCountryCode

Länder-/Regionscode der Partei, an die der Anruf weitergeleitet wird. Wenn der Wert 0 angegeben wird, wird von der Implementierung ein Standardwert 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 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Hinweise

Mit der Anrufumleitung kann eine Anwendung einen Angebotsaufruf an eine andere Adresse weiterleiten, ohne den Anruf zuerst zu beantworten. Die Anrufumleitung unterscheidet sich von der Anrufweiterleitung darin, dass die Anrufweiterleitung durch den Switch ohne Beteiligung der Anwendung erfolgt; Die Umleitung kann auf Call-by-Call-Basis durch die Anwendung erfolgen, z. B. gesteuert durch Anrufer-ID-Informationen. Es unterscheidet sich von der Anrufübertragung darin, dass für die Übertragung eines Anrufs der Anruf zuerst beantwortet werden muss.

Nachdem ein Anruf erfolgreich umgeleitet wurde, wechselt der Anruf in der Regel in den Leerlauf.

Neben der Umleitung eines eingehenden Anrufs kann eine Anwendung die Möglichkeit haben, den Anruf mithilfe von lineAccept anzunehmen, den Anruf mit lineDrop abzulehnen oder den Anruf mithilfe von lineAnswer zu beantworten. Die Verfügbarkeit dieser Vorgänge hängt von den Gerätefunktionen ab.