lineSetAgentGroup  58IN_00 

The lineSetAgentGroup function sets the agent groups into which the agent is logged into on a particular address.

LONG lineSetAgentGroup(

    HLINE hLine,

 

    DWORD dwAddressID,

 

    LPLINEAGENTGROUPLIST lpAgentGroupList

 

   );

 

 

Parameters

hLine

Handle of the line device.

dwAddressID

Identifier of the address for which the agent information is to be changed.

lpAgentList

Pointer to a LINEAGENTGROUPLIST.D1TA5 structure identifying the groups into which the current agent is to be logged in on the address. If the pointer is NULL or the number of groups in the indicated structure is 0, then the agent is logged out of any ACD groups into which the agent is then logged in.

Note that the "Name" fields in the LINEAGENTGROUPENTRYAW9NX6 items in the list are ignored for purposes of this function; the control of the logged-in groups is based on the group ID values only.

 

Return Values

Returns a positive request identifier if the asynchronous operation starts; otherwise, one of these negative error values:

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTGROUP, LINEERR_INVALAGENTID, LINEERR_INVALAGENTSKILL, LINEERR_INVALAGENTSUPERVISOR, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPASSWORD, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED. 

See Also

LINEAGENTGROUPENTRY, LINEAGENTGROUPLIST