Funzione lineSetAgentState (tapi.h)

La funzione lineSetAgentState imposta lo stato dell'agente associato a un indirizzo specifico.

Sintassi

LONG lineSetAgentState(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwAgentState,
  DWORD dwNextAgentState
);

Parametri

hLine

Handle per il dispositivo line.

dwAddressID

Identificatore dell'indirizzo per il quale devono essere modificate le informazioni dell'agente. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwAgentState

Nuovo stato dell'agente. Deve essere una delle costanti LINEAGENTSTATE_ oppure zero per lasciare invariato lo stato dell'agente e modificare solo lo stato successivo.

dwNextAgentState

Stato dell'agente che deve essere impostato automaticamente quando la chiamata corrente sull'indirizzo diventa inattiva. Ad esempio, se è noto che è necessario eseguire il lavoro dopo la chiamata, questo campo può essere impostato su LINEAGENTSTATE_WORKAFTERCALL in modo che una nuova chiamata non venga assegnata all'agente dopo la chiamata corrente. Deve essere una delle costanti LINEAGENTSTATE_ oppure zero per usare lo stato successivo predefinito configurato per l'agente.

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_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.

Requisiti

Vedi anche

Funzioni supplementari del servizio line

Panoramica dei riferimenti a TAPI 2.2