lineReleaseUserUserInfo-Funktion (tapi.h)

Artikel
08/26/2023

Die LineReleaseUserUserInfo-Funktion informiert den Dienstanbieter darüber, dass die Anwendung die benutzerbezogenen Informationen in der LINECALLINFO-Struktur verarbeitet hat und dass anschließend benutzer-benutzerbezogene Informationen in diese Struktur geschrieben werden können. Der Dienstanbieter sendet eine LINE_CALLINFO Nachricht, die angibt, LINECALLINFOSTATE_USERUSERINFO, wenn neue Informationen verfügbar sind.

Syntax

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

Parameter

hCall

Behandeln Sie den Anruf. Die Anwendung muss besitzer des Aufrufs sein. Der Anrufstatus von hCall kann ein beliebiger Zustand sein.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED, LINEERR_OPERATIONUNAVAIL.

Hinweise

Mit der Funktion lineReleaseUserUserInfo kann die Anwendung den Fluss eingehender Benutzer-Benutzer-Informationen über eine ISDN-Verbindung steuern. Wenn eine neue, vollständige Benutzerinformationsnachricht empfangen wird, informiert der Dienstanbieter die Anwendung mithilfe einer LINE_CALLINFO-Nachricht (gibt LINECALLINFOSTATE_USERUSERINFO an). Eine beliebige Anzahl von Anwendungen kann die Informationen untersuchen (mithilfe von lineGetCallInfo), aber die Anwendung, die die Aufrufe besitzt, steuert, wenn die Informationen freigegeben werden, sodass nachfolgende Informationen gemeldet werden können. Der Dienstanbieter überschreibt vorherige Benutzerinformationen in LINECALLINFO erst nach dem Aufruf von lineReleaseUserUserInfo mit neueren Informationen. Es liegt in der Verantwortung des Dienstanbieters, anschließend empfangene Benutzer-Benutzer-Informationen zu puffern, bis die vorherigen Informationen von der Anwendung freigegeben werden, die den Aufruf besitzt.