funzione lineProxyMessage (tapi.h)

La funzione lineProxyMessage viene usata da un gestore di richieste proxy registrato per generare messaggi TAPI correlati al suo ruolo. Ad esempio, un gestore dell'agente ACD può usare questa funzione per generare LINE_AGENTSTATUS messaggi ricevuti da tutte le applicazioni con la riga specificata aperta. TAPI elimina la generazione del messaggio nell'hLine specificata nei parametri della funzione.

Sintassi

LONG lineProxyMessage(
  HLINE hLine,
  HCALL hCall,
  DWORD dwMsg,
  DWORD dwParam1,
  DWORD dwParam2,
  DWORD dwParam3
);

Parametri

hLine

Gestire il dispositivo a riga aperta. Questa operazione viene convertita da TAPI nell'hLine corretta per ogni applicazione che riceve il messaggio.

hCall

Se il messaggio è correlato a una chiamata specifica (che non è, nel caso di LINE_AGENTSTATUS), specifica l'handle del gestore proxy per tale chiamata; deve essere impostato su NULL per i messaggi non correlati a una chiamata specifica. Questa operazione viene convertita da TAPI nell'hCall corretta per ogni applicazione che riceve il messaggio.

dwMsg

Messaggio TAPI da generare. Questo deve essere un messaggio che può essere generato dai gestori proxy.

dwParam1

Parametro associato al messaggio da inviare.

dwParam2

Parametro associato al messaggio da inviare.

dwParam3

Parametro associato al messaggio da inviare.

Valore restituito

Restituisce zero se la funzione ha esito positivo o uno di questi valori di errore negativi:

LINEERR_INVALLINEHANDLE, LINEERR_INVALCALLHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_NOTREGISTERED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Requisiti

Vedi anche

LINE_AGENTSTATUS

Funzioni di servizio linea supplementari

Panoramica di riferimento su TAPI 2.2