TSPI_lineReleaseUserUserInfo-Funktion (tspi.h)

Artikel
08/26/2023

Die TSPI_lineReleaseUserUserInfo-Funktion informiert den Dienstanbieter darüber, dass die in der LINECALLINFO-Struktur enthaltenen Benutzer-Benutzer-Informationen verarbeitet wurden und dass anschließend empfangene Benutzer-Benutzer-Informationen nun in diese Struktur geschrieben werden können. Der Dienstanbieter sendet eine LINE_CALLINFO Meldung, die angibt, LINECALLINFOSTATE_USERUSERINFO, wann neue Informationen verfügbar sind.

Syntax

LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parameter

dwRequestID

Der Bezeichner der asynchronen Anforderung.

hdCall

Das Handle des Dienstanbieters für den Aufruf, für den Benutzer-/Benutzerinformationen freigegeben werden sollen. Der Aufrufstatus von hdCall kann beliebig sein.

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_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Hinweise

Die TSPI_lineReleaseUserUserInfo-Funktion ermöglicht die Steuerung des Flusses eingehender Benutzer-/Benutzerinformationen zu einer ISDN-Verbindung. Wenn eine neue, vollständige Benutzer-/Benutzerinformationsmeldung empfangen wird, informiert der Dienstanbieter TAPI mithilfe einer LINE_CALLINFO-Nachricht (unter Angabe LINECALLINFOSTATE_USERUSERINFO). Die Benutzerinformationen und andere Felder in LINECALLINFO können durch mehrere Aufrufe von TSPI_lineGetCallInfo überprüft werden. Der Dienstanbieter darf vorherige Benutzer-/Benutzerinformationen in LINECALLINFO erst nach dem Aufruf TSPI_lineReleaseUserUserInfo mit neueren Informationen überschreiben. Der Dienstanbieter muss anschließend empfangene Benutzer-/Benutzerinformationen puffern, bis die vorherigen Informationen freigegeben werden. Alle verbleibenden gepufferten Informationen können verworfen werden, wenn TSPI_lineCloseCall aufgerufen wird.

Wenn diese Funktion aufgerufen wird, während in LINECALLINFO keine Benutzer-Benutzer-Informationen vorhanden sind, sollte der Dienstanbieter dennoch einen Erfolgshinweis zurückgeben.

Aus Gründen der Abwärtskompatibilität gibt TAPI automatisch LINEERR_OPERATIONUNAVAIL zurück, wenn diese Funktion für einen Aufruf in einer Zeile unter der Kontrolle eines Dienstanbieters aufgerufen wird, der die Funktion nicht exportiert.