lineSendUserUserInfo-Funktion (tapi.h)

Artikel
08/26/2023

Die lineSendUserUserInfo-Funktion sendet Benutzer-Benutzer-Informationen an die Remotepartei bei dem angegebenen Aufruf.

Syntax

LONG lineSendUserUserInfo(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parameter

hCall

Verarbeiten Sie den Anruf, über den Benutzer-/Benutzerinformationen gesendet werden sollen. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus von hCall muss verbunden, angeboten, akzeptiert oder zurückgerufen werden.

lpsUserUserInfo

Zeiger auf eine Zeichenfolge, die Benutzer-/Benutzerinformationen enthält, die an die Remotepartei gesendet werden sollen. Benutzer-/Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (siehe LINEDEVCAPS). Das Protokoll-Diskriminatorfeld für die Benutzer-/Benutzerinformationen sollte bei Bedarf als erstes Byte des Puffers angezeigt werden, auf den lpsUserUserInfo verweist, und muss in dwSize berücksichtigt werden.

dwSize

Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo in Byte.

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 null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Hinweise

Diese Funktion kann verwendet werden, um während eines verbundenen Anrufs jederzeit Benutzer-/Benutzerinformationen zu senden. Wenn die Größe der zu sendenden Informationen größer ist als die Größe, die in eine einzelne Netzwerknachricht passen kann (wie in ISDN), ist der Dienstanbieter dafür verantwortlich, die Informationen in eine Sequenz verketteter Netzwerknachrichten zu unterteilen (mit "mehr Daten").

Benutzer-Benutzer-Informationen können auch im Rahmen der Anrufannahme, der Anrufzurückweisung und der Anrufumleitung sowie beim Tätigen von Anrufen gesendet werden. Benutzer-/Benutzerinformationen können ebenfalls empfangen werden. Die empfangenen Informationen sind über den Anrufinformationsdatensatz des Anrufs verfügbar. Wenn Benutzer-Benutzer-Informationen nach dem Anrufangebot oder vor der Verbindungstrennung eingehen, benachrichtigt eine LINE_CALLINFO Nachricht mit einem UserUserInfo-Parameter die Anwendung darüber, dass benutzer-benutzer-Informationen im Anrufinformationsdatensatz geändert wurden. Wenn mehrere Netzwerknachrichten verkettet sind, werden die Informationen vom Dienstanbieter zusammengestellt, und eine einzelne Nachricht wird an die Anwendung gesendet.

Diese Funktion kann Daten unverschlüsselt über das Kabel senden; Daher kann jemand, der im Netzwerk lauscht, die Daten lesen. Das Sicherheitsrisiko beim Senden der Daten im Klartext sollte vor der Verwendung dieser Methode berücksichtigt werden.