lineSetCallTreatment-Funktion (tapi.h)

Artikel
03/02/2024

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.