Funzione lineGetAgentCapsA (tapi.h)

Articolo
08/26/2023

La funzione lineGetAgentCaps ottiene le funzionalità correlate all'agente supportate nel dispositivo line specificato. Se viene denominato un agente specifico, le funzionalità includono un elenco di gruppi di ACD in cui l'agente è autorizzato ad accedere.

Sintassi

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Parametri

hLineApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Dispositivo linea contenente l'indirizzo su cui eseguire una query.

dwAddressID

Indirizzo nel dispositivo linea specificato le cui funzionalità devono essere sottoposte a query. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwAppAPIVersion

Versione più recente dell'API supportata dall'applicazione. Questo non deve essere il valore negoziato usando lineNegotiateAPIVersion nel dispositivo su cui viene eseguita una query.

lpAgentCaps

Puntatore a una struttura di dimensioni variabili di tipo LINEAGENTCAPS. Al termine della richiesta, questa struttura viene compilata con informazioni sulle funzionalità dell'agente. Prima di chiamare lineGetAgentCaps, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

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_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Commenti

Nota

L'intestazione tapi.h definisce lineGetAgentCaps 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.