lineBlindTransfer-Funktion (tapi.h)

Artikel
08/26/2023

Die lineBlindTransfer-Funktion führt eine blinde oder einstufige Übertragung des angegebenen Aufrufs an die angegebene Zieladresse durch.

Syntax

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

Parameter

hCall

Handle an den zu übertragenden Aufruf. Die Anwendung muss besitzer dieses Aufrufs sein. Der Anrufstatus von hCall muss verbunden sein.

lpszDestAddress

TBD

dwCountryCode

Landes- oder Regionscode des Ziels. Dies wird von der Implementierung verwendet, um die Anrufstatusprotokolle für die Zieladresse auszuwählen. Wenn der Wert 0 angegeben wird, wird ein vom Dienstanbieter definiertes Standardprotokoll für den Anrufstatus 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_INVALCALLHANDLE, LINEERR_INVALCOUNTRYCODE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_ADDRESSBLOCKED, LINEERR_OPERATIONFAILED.

Hinweise

Wenn LINEERR_INVALADDRESS zurückgegeben wird, erfolgt keine Wahl.

Blindtransfer unterscheidet sich von einem Beratungstransfer dadurch, dass kein Beratungsgespräch für die Anwendung sichtbar gemacht wird. Nachdem die Blindübertragung erfolgreich abgeschlossen wurde, wird der angegebene Aufruf in der Regel aus der Zeile der Anwendung gelöscht und wechselt in den Leerlaufzustand .

Das Aufrufhandle der Anwendung bleibt nach Abschluss der Übertragung gültig. Die Anwendung muss ihr Handle mithilfe von lineDeallocateCall behandeln, wenn sie nicht mehr an dem übertragenen Aufruf interessiert ist.