TSPI_lineBlindTransfer-Funktion (tspi.h)
Die funktion TSPI_lineBlindTransfer führt eine blinde oder einstufige Übertragung des angegebenen Aufrufs an die angegebene Zieladresse durch.
Syntax
LONG TSPIAPI TSPI_lineBlindTransfer(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdCall
Das Handle des Dienstanbieters für den zu übertragenden Anruf. Der Anrufstatus von hdCall kann verbunden werden.
lpszDestAddress
Ein Zeiger auf eine Unicode-Zeichenfolge, die null endet, die an gibt, wohin der Aufruf übertragen werden soll. Die Zieladresse verwendet das Standardformat für wählbare Nummern.
dwCountryCode
Der Länder- oder Regionscode des Ziels. Die Implementierung sollte dies verwenden, um die Aufrufstatusprotokolle für die Zieladresse auszuwählen. Wenn der Wert 0 angegeben wird, sollte der Dienstanbieter einen Standardwert verwenden. TAPI überprüft dwCountryCode nicht, wenn diese Funktion aufgerufen wird.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_ADDRESSBLOCKED, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE.
Hinweise
Der Dienstanbieter führt keine Wählfunktion durch, wenn er LINEERR_INVALADDRESS zurückgibt.
Blindtransfer unterscheidet sich von einer Konsultationsübertragung darin, dass keine Konsultationsgespräche für TAPI sichtbar gemacht werden. In der Regel wird der angegebene Aufruf nach erfolgreichem Abschluss der Blindübertragung aus der Zeile gelöscht, in der er sich befand, und wechselt in den Leerlaufzustand . Das Anrufhandle des Dienstanbieters muss nach Abschluss der Übertragung gültig bleiben. TapI bewirkt, dass dieses Handle ungültig wird, wenn es nicht mehr an dem übertragenen Anruf mithilfe von TSPI_lineCloseCall interessiert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |