Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |