lineRedirectW-Funktion (tapi.h)

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

Syntax

LONG lineRedirectW(
  HCALL   hCall,
  LPCWSTR lpszDestAddress,
  DWORD   dwCountryCode
);

Parameter

hCall

Behandeln Sie den Anruf, der umgeleitet werden soll. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus hCall- muss anbieten.

lpszDestAddress

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

dwCountryCode

Der Code für Land/Region der Partei, zu der der Anruf umgeleitet wird. Wenn ein Wert von 0 angegeben wird, wird eine Standardeinstellung von der Implementierung 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 Nachricht ist null, wenn die Funktion erfolgreich ist oder eine negative Fehlernummer ist, 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.

Bemerkungen

Die Anrufumleitung ermöglicht es einer Anwendung, einen Angebotsanruf an eine andere Adresse zu verschieben, ohne zuerst den Anruf zu beantworten. Die Anrufumleitung unterscheidet sich von der Anrufweiterleitung in dieser Anrufweiterleitung durch den Switch ohne Beteiligung der Anwendung; Die Umleitung kann von der Anwendung auf Anrufbasis erfolgen, z. B. durch Anrufer-ID-Informationen gesteuert. Es unterscheidet sich von der Anrufdurchstellung, bei der das Durchstellen eines Anrufs erfordert, dass der Anruf zuerst angenommen wird.

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

Neben der Umleitung eines eingehenden Anrufs kann eine Anwendung den Anruf mit lineAcceptannehmen, den Anruf mit lineDropablehnen oder den Anruf mit lineAnswerannehmen. Die Verfügbarkeit dieser Vorgänge hängt von den Gerätefunktionen ab.

Anmerkung

Der header tapi.h definiert lineRedirect als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

LINE_REPLY

Übersicht über Umleitung

Ergänzende Line-Service-Funktionen

TAPI 2.2 Referenzübersicht

lineAccept-

lineAnswer

lineDrop-