Funzione lineGetQueueListA (tapi.h)

Articolo
03/02/2024

La funzione lineGetQueueList restituisce un elenco di code associate a un determinato gruppo 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_GETQUEUELIST.

Sintassi

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

Parametri

hLine

Handle per il dispositivo line.

lpGroupID

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

lpQueueList

Puntatore a una struttura di dimensioni variabili 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 relativo all'allocazione della 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.

Commenti

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 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.