Share via


lineSetCallData-Funktion (tapi.h)

Die lineSetCallData-Funktion legt das CallData-Element in LINECALLINFO fest. Abhängig von der Dienstanbieterimplementierung kann das CallData-Element an alle Anwendungen weitergegeben werden, die Überhands für den Aufruf haben, einschließlich solcher auf anderen Computern (über den Server), und kann mit dem Anruf übertragen werden, wenn er übertragen wird.

Syntax

LONG lineSetCallData(
  HCALL  hCall,
  LPVOID lpCallData,
  DWORD  dwSize
);

Parameter

hCall

Handle für den Aufruf. Die Anwendung muss über die BERECHTIGUNG OWNER verfügen.

lpCallData

Die Adresse der Daten, die in das CallData-Element in LINECALLINFO kopiert werden sollen, wobei alle vorhandenen Daten ersetzt werden. Weitere Informationen finden Sie im Thema Anrufdaten .

dwSize

Anzahl der zu kopierenden Datenbytes. Der Wert 0 bewirkt, dass alle vorhandenen Daten entfernt werden.

Hinweis Wenn lpCallData ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlusszeichen enthalten.
 

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird. Andernfalls gibt die Funktion einen der folgenden negativen Fehlerwerte zurück:

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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi.h
Bibliothek Tapi32.lib
DLL Tapi32.dll

Weitere Informationen

LINECALLINFO

Ergänzende Zeilendienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz