TSPI_lineRedirect-Funktion (tspi.h)
Die TSPI_lineRedirect-Funktion leitet den angegebenen Angebotsaufruf an die angegebene Zieladresse um.
Syntax
LONG TSPIAPI TSPI_lineRedirect(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdCall
Das Handle für den Umleitungsaufruf. Der Anrufstatus von hdCall kann angeboten werden.
lpszDestAddress
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Termin, die die Zieladresse angibt. Dies entspricht dem Standardmäßigen Linkformat.
dwCountryCode
Der Länder- oder Regionscode der Partei, an die der Anruf weitergeleitet wird. Wenn der Wert 0 angegeben wird, wird von der Implementierung ein Standardwert verwendet. Dieser Parameter wird nicht von TAPI überprüft, 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_INVALCOUNTRYCODE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.
Hinweise
Der Dienstanbieter leitet den Aufruf nicht um, wenn er LINEERR_INVALADDRESS zurückgibt.
Wenn diese Funktion aufgerufen wird, lenkt der Dienstanbieter den Angebotsaufruf an eine andere Adresse ab, ohne den Anruf zuerst entgegennehmen zu müssen. Die Anrufumleitung unterscheidet sich von der Anrufweiterleitung darin, dass die Anrufweiterleitung durch den Schalter ohne Beteiligung der angerufenen Station erfolgt; Die Umleitung kann call-by-call-Basis von einer Clientanwendung erfolgen, z. B. gesteuert durch Anrufer-ID-Informationen. Er unterscheidet sich von der Anrufübertragung darin, dass für die Übertragung eines Anrufs zunächst die Anrufanhörung erforderlich ist.
Nachdem ein Aufruf erfolgreich umgeleitet wurde, wechselt der Aufruf in der Regel in den Leerlauf. Der Dienstanbieter gibt den neuen Status mithilfe einer LINE_CALLSTATE-Nachricht an.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | tspi.h |