Funzione lineGetGroupListA (tapi.h)

Articolo
11/20/2024

La funzione lineGetGroupList restituisce un elenco di gruppi ACD disponibili nel sistema ACD. Genera un messaggio di LINE_PROXYREQUEST da inviare a un gestore di funzioni proxy registrato, facendo riferimento a una struttura LINEPROXYREQUEST di tipo LINEPROXYREQUEST_GETGROUPLIST.

Sintassi

LONG lineGetGroupListA(
  HLINE                hLine,
  LPLINEAGENTGROUPLIST lpGroupList
);

Parametri

hLine

Handle per il dispositivo linea.

lpGroupList

Puntatore a una struttura di dimensioni variabili di tipo LINEAGENTGROUPLIST. Al termine della richiesta, questa struttura viene compilata con un elenco dei gruppi ACD disponibili. Prima di chiamare la funzione lineGetGroupList , l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire informazioni.

Nota Se i parametri di dimensione nella struttura non sono corretti, è possibile che i dati vengano sovrascritti. Per altre informazioni sull'impostazione delle dimensioni della struttura, vedere l'argomento allocazione di memoria.

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.

Osservazioni

Nota

L'intestazione tapi.h definisce lineGetGroupList 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.