TSPI_lineSendUserUserInfo-Funktion (tspi.h)
Die TSPI_lineSendUserUserInfo-Funktion sendet Benutzer-Benutzer-Informationen an die Remotepartei für den angegebenen Aufruf.
Syntax
LONG TSPIAPI TSPI_lineSendUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdCall
Das Handle für den Aufruf, über den Benutzerinformationen gesendet werden sollen. Der Anrufstatus von hdCall kann verbunden, angeboten, akzeptiert oder zurückgenommen werden.
lpsUserUserInfo
Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die Benutzer-Benutzer-Informationen enthält, die an die Remotepartei gesendet werden sollen. Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (siehe LINEDEVCAPS).
dwSize
Die Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo in Bytes, einschließlich des NULL-Abschlusszeichens.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter des entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.
Hinweise
Diese Funktion kann verwendet werden, um während eines verbundenen Anrufs jederzeit Benutzerinformationen zu senden. Wenn die Größe der angegebenen 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 von verketteten Netzwerknachrichten aufzuteilen (mit "Mehr Daten").
Benutzerinformationen können auch im Rahmen von Anrufannahme, Ablehnung von Anrufen, Anrufumleitung und beim Tätigen von Anrufen gesendet werden. Benutzerinformationen können auch empfangen werden. Die empfangenen Informationen werden in der LINECALLINFO-Struktur des Aufrufs gemeldet. Immer wenn Benutzerinformationen nach dem Anrufangebot oder vor der Verbindungstrennung eintreffen, benachrichtigt eine LINE_CALLINFO Nachricht mit einem UserUserInfo-Parameter TAPI 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 TAPI gesendet.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |