Funzione lineSetAgentGroup (tapi.h)

Articolo
03/05/2024

La funzione lineSetAgentGroup imposta i gruppi di agenti in cui l'agente è connesso in un indirizzo specifico.

Sintassi

LONG lineSetAgentGroup(
  HLINE                hLine,
  DWORD                dwAddressID,
  LPLINEAGENTGROUPLIST lpAgentGroupList
);

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.

lpAgentGroupList

Puntatore a una struttura LINEAGENTGROUPLIST che identifica i gruppi in cui deve essere connesso l'agente corrente nell'indirizzo. Se il puntatore è NULL o il numero di gruppi nella struttura indicata è zero, l'agente viene disconnesso da qualsiasi gruppo ACD in cui è attualmente connesso.

I campi "Name" negli elementi LINEAGENTGROUPENTRY nell'elenco vengono ignorati ai fini di questa funzione; il controllo dei gruppi connessi è basato solo sui valori dell'identificatore di gruppo.

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_INVALAGENTGROUP, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPASSWORD, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.