lineBlindTransferW-Funktion (tapi.h)

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

Syntax

LONG lineBlindTransferW(
  HCALL   hCall,
  LPCWSTR lpszDestAddressW,
  DWORD   dwCountryCode
);

Parameter

hCall

Behandeln Sie den Anruf, der übertragen werden soll. Die Anwendung muss ein Besitzer dieses Anrufs sein. Der Anrufstatus hCall- muss verbunden sein.

lpszDestAddressW

Zeiger auf eine mit Null beendete Zeichenfolge, die an die Stelle zeigt, an die der Aufruf übertragen werden soll. Die Zieladresse verwendet das standardwählbare Nummernformat.

dwCountryCode

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

Bemerkungen

Wenn LINEERR_INVALADDRESS zurückgegeben wird, tritt keine Wählverbindung auf.

Blindtransfer unterscheidet sich von einem Beratungstransfer, da für die Bewerbung kein Konsultationsgespräch sichtbar ist. Nachdem die Blindübertragung erfolgreich abgeschlossen wurde, wird der angegebene Aufruf in der Regel aus der Zeile der Anwendung gelöscht und wechselt zum leerlauf Zustand.

Der Anrufhandle der Anwendung bleibt gültig, nachdem die Übertragung abgeschlossen wurde. Die Anwendung muss ihr Handle mit lineDeallocateCall abwickeln, wenn sie nicht mehr an dem durchgestellten Anruf interessiert ist.

Anmerkung

Der header tapi.h definiert lineBlindTransfer 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

Ergänzende Line-Service-Funktionen

TAPI 2.2 Referenzübersicht

Transferübersicht

lineDeallocateCall