TSPI_lineAnswer-Funktion (tspi.h)

Artikel
03/03/2024

Die TSPI_lineAnswer-Funktion beantwortet den angegebenen Angebotsaufruf.

Syntax

LONG TSPIAPI TSPI_lineAnswer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parameter

dwRequestID

Der Bezeichner der asynchronen Anforderung.

hdCall

Das Handle des Dienstanbieters für den Anruf, der beantwortet werden soll. Der Anrufstatus von hdCall kann anbieten oder akzeptiert sein.

lpsUserUserInfo

Ein Zeiger auf eine Zeichenfolge mit NULL-Beendigung, die Benutzer-Benutzer-Informationen enthält, die zum Zeitpunkt der Entgegennehmen des Anrufs an die Remotepartei gesendet werden sollen. Wenn dieser Zeiger NULL ist, gibt er an, dass keine Benutzer-/Benutzerinformationen gesendet werden sollen. Benutzer-/Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (wie in LINEDEVCAPS angegeben).

dwSize

Die Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo in Byte. Wenn lpsUserUserInfoNULL ist, wird dwSize ignoriert.

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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INUSE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG.

Hinweise

Wenn ein neuer Anruf eingeht, sendet der Dienstanbieter TAPI eine LINE_NEWCALL Nachricht, um Handles für den Anruf auszutauschen. Der Dienstanbieter folgt diesem Mit einer LINE_CALLSTATE-Nachricht , um TAPI und seine Clientanwendungen über den Zustand des Aufrufs zu informieren. Eine Clientanwendung beantwortet den Anruf in der Regel mit TSPI_lineAnswer. In der Regel wechselt der Anruf, nachdem der Anruf erfolgreich angenommen wurde, in den Zustand verbunden .

In einigen Telefonieumgebungen (z. B. ISDN), in denen Benutzerwarnungen vom Anrufangebot getrennt sind, haben TAPI und die zugehörigen Clientanwendungen möglicherweise die Möglichkeit, einen Anruf zuerst anzunehmen, bevor sie antworten, oder stattdessen den Angebotsanruf abzulehnen oder umzuleiten.

Wenn ein Anruf angeboten wird, wenn bereits ein anderer Anruf aktiv ist, wird der neue Anruf durch Aufrufen TSPI_lineAnswer verbunden. Welche Auswirkungen dies auf den vorhandenen aktiven Aufruf hat, hängt von den Gerätefunktionen der Leitung ab. Der erste Aufruf ist möglicherweise nicht betroffen, er wird möglicherweise automatisch gelöscht oder automatisch in den Halteraum gesetzt. Die entsprechenden LINE_CALLSTATE Nachrichten werden verwendet, um Zustandsübergänge für beide Aufrufe an TAPI zu melden.