lineGetQueueListA, fonction (tapi.h)

Article
11/20/2024

La fonction lineGetQueueList retourne une liste de files d’attente associée à un groupe ACD particulier. Il génère un message LINE_PROXYREQUEST à envoyer à un gestionnaire de fonction proxy inscrit, référençant une structure LINEPROXYREQUEST de type LINEPROXYREQUEST_GETQUEUELIST.

Syntaxe

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

Paramètres

hLine

Gérez l’appareil de ligne.

lpGroupID

Pointeur vers GUID qui identifie le groupe pour lequel la liste des files d’attente est demandée.

lpQueueList

Pointeur vers une structure de type LINEQUEUELISTde taille variable. Une fois la requête terminée, cette structure est remplie avec une liste de files d’attente. Avant d’appeler lineGetQueueList, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour renvoyer des informations.

Remarque Si les paramètres de taille de la structure ne sont pas corrects, il est possible que les données puissent être remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique l’allocation de mémoire.

Valeur de retour

Retourne un identificateur de demande si l’opération asynchrone démarre ; sinon, la fonction retourne l’une des valeurs d’erreur suivantes :

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

Remarques

Note

L’en-tête tapi.h définit lineGetQueueList comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.