fonction lineGetGroupListA (tapi.h)

Article
08/26/2023

La fonction lineGetGroupList retourne une liste de groupes ACD disponibles sur le système ACD. 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_GETGROUPLIST.

Syntaxe

LONG lineGetGroupListA(
  HLINE                hLine,
  LPLINEAGENTGROUPLIST lpGroupList
);

Paramètres

hLine

Gérez l’appareil de ligne.

lpGroupList

Pointeur vers une structure de taille variable de type LINEAGENTGROUPLIST. Une fois la demande terminée, cette structure est remplie avec une liste des groupes ACD disponibles. Avant d’appeler la fonction lineGetGroupList , l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

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

Valeur retournée

Retourne un identificateur de requête 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 lineGetGroupList 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.