lineSetAppSpecific-Funktion (tapi.h)

Artikel
03/02/2024

Mit der lineSetAppSpecific-Funktion kann eine Anwendung das anwendungsspezifische Feld des Anrufinformationsdatensatzes des angegebenen Aufrufs festlegen.

Syntax

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

Parameter

hCall

Behandeln Sie den Aufruf, dessen anwendungsspezifisches Feld festgelegt werden muss. Die Anwendung muss besitzer des Aufrufs sein. Der Anrufstatus von hCall kann ein beliebiger Zustand sein.

dwAppSpecific

Neuer Inhalt des dwAppSpecific-Elements für die LINECALLINFO-Struktur des Aufrufs. Dieser Wert wird von der Telefonie-API nicht interpretiert.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

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

Hinweise

Das anwendungsspezifische Feld in der LINECALLINFO-Datenstruktur , das für jeden Aufruf vorhanden ist, wird nicht von der Telefonie-API oder einem ihrer Dienstanbieter interpretiert. Die Verwendung wird vollständig durch die Anwendungen definiert. Das Feld kann aus dem LINECALLINFO-Datensatz gelesen werden, der von lineGetCallInfo zurückgegeben wird. Allerdings muss lineSetAppSpecific verwendet werden, um das Feld so festzulegen, dass Änderungen für andere Anwendungen sichtbar werden. Wenn dieses Feld geändert wird, erhalten alle anderen Anwendungen mit Aufrufhandles eine LINE_CALLINFO Nachricht mit dem Hinweis, dass sich der dwAppSpecific-Member geändert hat.