Função lineSetAgentGroup (tapi.h)
A função lineSetAgentGroup define os grupos de agentes nos quais o agente está conectado em um endereço específico.
Sintaxe
LONG lineSetAgentGroup(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTGROUPLIST lpAgentGroupList
);
Parâmetros
hLine
Identificador para o dispositivo de linha.
dwAddressID
Identificador do endereço para o qual as informações do agente devem ser alteradas. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.
lpAgentGroupList
Ponteiro para uma estrutura LINEAGENTGROUPLIST que identifica os grupos nos quais o agente atual deve ser conectado no endereço. Se o ponteiro for NULL ou o número de grupos na estrutura indicada for zero, o agente será desconectado de todos os grupos ACD nos quais ele está conectado no momento.
Os campos "Name" nos itens LINEAGENTGROUPENTRY na lista são ignorados para fins dessa função; o controle dos grupos conectados baseia-se apenas nos valores do identificador de grupo.
Retornar valor
Retorna um identificador de solicitação positivo se a operação assíncrona for iniciada; caso contrário, a função retornará um destes valores de erro negativos:
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |