Funzione lineGetAgentGroupListA (tapi.h)

  • Articolo

La funzione lineGetAgentGroupList ottiene le identità dei gruppi di agenti (combinazione di coda, supervisore, livello di competenza e così via) in cui l'agente attualmente connesso alla workstation è autorizzato ad accedere al server di distribuzione delle chiamate automatico.

Sintassi

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

Parametri

hLine

Handle per il dispositivo a riga aperta.

dwAddressID

Indirizzo nel dispositivo a riga aperta il cui stato dell'agente deve essere sottoposto a query.

lpAgentGroupList

Puntatore a una struttura con dimensioni variabili di tipo LINEAGENTGROUPLIST. Al termine della richiesta, questa struttura viene compilata con un elenco dei gruppi di agenti in cui l'agente può accedere in questo momento (che deve includere tutti i gruppi in cui l'agente è già connesso, se presente).

Valore restituito

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

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Commenti

Nota

L'intestazione tapi.h definisce lineGetAgentGroupList come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi.h
Libreria Tapi32.lib
DLL Tapi32.dll

Vedi anche

LINEAGENTGROUPLIST

Funzioni supplementari del servizio line

Panoramica dei riferimenti a TAPI 2.2