Funzione lineGetQueueListA (tapi.h)

Articolo
11/20/2024

La funzione lineGetQueueList restituisce un elenco di code associate a un determinato gruppo ACD. Genera un messaggio LINE_PROXYREQUEST da inviare a un gestore di funzioni proxy registrato, facendo riferimento a una struttura LINEPROXYREQUEST di tipo LINEPROXYREQUEST_GETQUEUELIST.

Sintassi

LONG lineGetQueueListA(
  HLINE           hLine,
  LPGUID          lpGroupID,
  LPLINEQUEUELIST lpQueueList
);

Parametri

hLine

Handle per il dispositivo linea.

lpGroupID

Puntatore a GUID che identifica il gruppo per il quale viene richiesto l'elenco di code.

lpQueueList

Puntatore a una struttura di tipo variabile di tipo LINEQUEUELIST. Al termine della richiesta, questa struttura viene compilata con un elenco di code. Prima di chiamare lineGetQueueList, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di 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 lineGetQueueList 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.