lineRedirect-Funktion (tapi.h)
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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | tapi.h |
Bibliothek | Tapi32.lib |
DLL | Tapi32.dll |
Weitere Informationen
Zusätzliche Zeilendienstfunktionen