lineSetCallTreatment-Funktion (tapi.h)
Die lineSetCallTreatment-Funktion legt die Sounds fest, die eine Partei bei einem Anruf, der nicht beantwortet wird, oder beim Anhalten hören. Mit Ausnahme der grundlegenden Parametervalidierung handelt es sich um eine direkte Passthrough-Instanz von TAPI an den Dienstanbieter.
Syntax
LONG lineSetCallTreatment(
HCALL hCall,
DWORD dwTreatment
);
Parameter
hCall
Handle für den Aufruf. Die Anwendung muss über die BERECHTIGUNG OWNER verfügen.
dwTreatment
Eine der Anrufbehandlungen, die für die Adresse unterstützt werden, unter der der Anruf angezeigt wird, wie durch LINEADDRESSCAPS angegeben. LINEERR_INVALPARAM wird zurückgegeben, wenn die angegebene Behandlung nicht unterstützt wird.
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_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Hinweise
Die Verwendung der Anrufbehandlungsfunktion sollte sich auf die Steuerung älterer Geräte beschränken. Neue Geräte sind im Allgemeinen so konzipiert, dass Aufrufe anstelle von Anrufbehandlungen durch externe Schaltgeräte mit PC-basierten Audioquellen und Signalen verbunden werden, die mithilfe von Standardfunktionen wie der Multimedia-Wave-API generiert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |