fonction lineGetQueueListA (tapi.h)
La fonction lineGetQueueList renvoie une liste de files d’attente associées à 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 le GUID qui identifie le groupe pour lequel la liste des files d’attente est demandée.
lpQueueList
Pointeur vers une structure de taille variable de type LINEQUEUELIST. Une fois la demande 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 à TAPI pour retourner des informations.
Valeur retournée
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
Notes
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. La combinaison 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.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | tapi.h |
Bibliothèque | Tapi32.lib |
DLL | Tapi32.dll |