funzione lineGetAgentInfo (tapi.h)

Articolo
08/26/2023

La funzione lineGetAgentInfo restituisce una struttura che contiene le informazioni ACD associate a un determinato handle agente. Genera un messaggio LINE_PROXYREQUEST da inviare a un gestore di funzioni proxy registrato, facendo riferimento a una struttura LINEPROXYREQUEST di tipo LINEPROXYREQUEST_GETAGENTINFO.

Sintassi

LONG lineGetAgentInfo(
  HLINE           hLine,
  HAGENT          hAgent,
  LPLINEAGENTINFO lpAgentInfo
);

Parametri

hLine

Gestire il dispositivo linea.

hAgent

Identificatore dell'agente le cui informazioni devono essere recuperate.

lpAgentInfo

Puntatore a una struttura di tipo LINEAGENTINFO. Se la richiesta ha esito positivo, questa struttura viene riempita con le statistiche dell'agente.

Valore restituito

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

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

Commenti

Prima di chiamare la funzione lineGetAgentInfo , l'applicazione deve impostare il membro dwTotalSize della struttura LINEAGENTINFO per indicare la quantità di memoria disponibile a TAPI per restituire informazioni.