TSPI_lineReleaseUserUserInfo-Funktion (tspi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |