lineSetAppSpecific-Funktion (tapi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |
Weitere Informationen
Referenz zu Grundlegenden Telefoniediensten