fonction lineSetAgentGroup (tapi.h)

Article
08/26/2023

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.