Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die lineSetupTransfer-Funktion initiiert eine Übertragung des durch den hCall--Parameter angegebenen Aufrufs. Sie richtet einen Konsultationsgespräch lphCallCallein, auf dem die Partei gewählt werden kann, die zum Ziel der Übertragung werden kann. Die Anwendung erwirbt besitzerrechte für den lphCall Parameter.
Syntax
LONG lineSetupTransferA(
HCALL hCall,
LPHCALL lphConsultCall,
LPLINECALLPARAMS const lpCallParams
);
Parameter
hCall
Behandeln Sie den Anruf, der übertragen werden soll. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus hCall- muss verbunden sein.
lphConsultCall
Zeiger auf einen hCall- Handle. Dieser Standort wird dann mit einem Handle geladen, der den temporären Konsultationstermin identifiziert. Bei der Einrichtung eines Anrufs für die Durchstellung wird automatisch ein Konsultationsgespräch zugewiesen, der es lineDial- ermöglicht, die adresse zu wählen, die dem neuen Übertragungsziel des Anrufs zugeordnet ist. Die Ursprungspartei kann vor Abschluss der Übertragung eine Unterhaltung über diesen Konsultationstermin führen. Der Anrufstatus von hCall ist nicht anwendbar.
Dieses Übertragungsverfahren ist für einige Leitungsgeräte möglicherweise nicht gültig. Möglicherweise muss der Antrag den neuen Konsultationsaufruf ignorieren und einen bestehenden gehaltenen Anruf (unter Verwendung von LineUnhold) ignorieren, um das Ziel der Übertragung zu identifizieren. Bei Schaltern, die die adressübergreifende Anrufdurchstellung unterstützen, kann der Konsultationsgespräch an einer anderen Adresse als dem zu übertragenden Anruf vorhanden sein. Es kann auch erforderlich sein, dass die Konsultationsgespräche durch lineMakeCallan das Ziel der Übertragung eingerichtet werden. Welche Übertragungsformen verfügbar sind, werden in den Adressfunktionen des Anrufs angegeben.
lpCallParams
Zeiger auf eine LINECALLPARAMS Struktur, die die Aufrufparameter enthält, die beim Einrichten des Konsultationsaufrufs verwendet werden sollen. Dieser Parameter kann auf NULL- festgelegt werden, wenn keine speziellen Aufrufsetupparameter erwünscht sind.
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_BEARERMODEUNAVAIL, LINEERR_INVALRATE, LINEERR_CALLUNAVAIL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLPARAMS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_INVALMEDIAMODE, LINEERR_USERUSERINFOTOOBIG, LINEERR_ INVALPOINTER.
Bemerkungen
Die funktion lineSetupTransfer richtet die Übertragung des durch hCallangegebenen Anrufs ein. In der Einrichtungsphase einer Übertragung wird ein Konsultationsgespräch eingerichtet, mit dem die Anwendung die Adresse des Ziels (die zu übertragende Partei) an den Schalter senden kann, während der zu übertragende Anruf gehalten wird. Dieser neue Anruf wird als Konsultationsgespräch (hCall) bezeichnet und kann unabhängig vom ursprünglichen Anruf verworfen oder anderweitig bearbeitet werden.
Wenn der Konsultationsanruf den Wählton Anrufstatus erreicht hat, kann die Anwendung die Übertragung des Anrufs fortsetzen, indem sie die Zieladresse wählt und den Fortschritt nachverfolgt oder einen vorhandenen Anruf nicht mehr einhält. Die Übertragung des ursprünglichen Anrufs an das ausgewählte Ziel wird mit lineCompleteTransferabgeschlossen.
Während der Konsultationsaufruf vorhanden ist, wechselt der ursprüngliche Aufruf in der Regel zum onholdPendingTransfer Zustand. Der Antrag kann mithilfe lineSwapHoldzwischen dem Konsultationsgespräch und dem ursprünglichen Anruf umschalten. Ein Konsultationsgespräch kann durch Aufrufen von lineDrop- storniert werden. Nach dem Ablegen eines Konsultationsanrufs wechselt der ursprüngliche Anruf in der Regel zurück zum verbundenen Zustand. Wenn der Anrufstatus des ursprünglichen Anrufs onholdPendingTransferist, kann die funktion lineUnhold zum Wiederherstellen des Anrufs verwendet werden. In diesem Fall wird der Anrufstatus des Konsultationsgesprächs auf leerfestgelegt.
Die Anwendung kann auch Anrufe in einem einzigen Schritt durchstellen, ohne sich mit dem dazwischen liegenden Konsultationsgespräch befassen zu müssen, indem lineBlindTransferverwendet wird.
Anmerkung
Der header tapi.h definiert lineSetupTransfer 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 |