Funzione lineSetCallTreatment (tapi.h)

La funzione lineSetCallTreatment imposta i suoni di una parte in una chiamata senza risposta o in attesa. Ad eccezione della convalida dei parametri di base, si tratta di un pass-through diretto da TAPI al provider di servizi.

Sintassi

LONG lineSetCallTreatment(
  HCALL hCall,
  DWORD dwTreatment
);

Parametri

hCall

Gestire la chiamata. L'applicazione deve avere il privilegio OWNER.

dwTreatment

Uno dei trattamenti di chiamata supportati sull'indirizzo in cui viene visualizzata la chiamata, come indicato da LINEADDRESSCAPS. LINEERR_INVALPARAM viene restituito se il trattamento specificato non è supportato.

Valore restituito

Restituisce un identificatore di richiesta positivo se l'operazione asincrona viene avviata; in caso contrario, la funzione restituisce uno dei valori di errore negativi seguenti:

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

Commenti

L'uso della funzionalità di trattamento delle chiamate deve essere limitato al controllo delle apparecchiature legacy. Le nuove apparecchiature sono generalmente progettate in modo che invece di chiamare trattamenti generati da apparecchiature di commutazione esterne, le chiamate sarebbero connesse a fonti audio basate su PC e segnali generati usando funzioni standard come l'API Wave multimediale.

Requisiti

Vedi anche

LINEADDRESSCAPS

Funzioni supplementari del servizio line

Panoramica dei riferimenti a TAPI 2.2