fonction lineSetAgentGroup (tapi.h)
La fonction lineSetAgentGroup définit les groupes d’agents dans lesquels l’agent est connecté à une adresse particulière.
Syntaxe
LONG lineSetAgentGroup(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTGROUPLIST lpAgentGroupList
);
Paramètres
hLine
Gérez l’appareil de ligne.
dwAddressID
Identificateur de l’adresse pour laquelle les informations de l’agent doivent être modifiées. Un identificateur d’adresse est associé de façon permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.
lpAgentGroupList
Pointeur vers une structure LINEAGENTGROUPLIST identifiant les groupes dans lesquels l’agent actuel doit être connecté sur l’adresse. Si le pointeur a la valeur NULL ou si le nombre de groupes dans la structure indiquée est égal à zéro, l’agent est déconnecté des groupes ACD dans lesquels il est actuellement connecté.
Les champs « Name » dans les éléments LINEAGENTGROUPENTRY de la liste sont ignorés aux fins de cette fonction ; le contrôle des groupes connectés est basé uniquement sur les valeurs d’identificateur de groupe.
Valeur retournée
Retourne un identificateur de demande positif si l’opération asynchrone démarre ; sinon, la fonction retourne l’une des valeurs d’erreur négatives suivantes :
LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTGROUP, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPASSWORD, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi.h |
| Bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |