Funzione lineSetAgentGroup (tapi.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |