Função lineCreateAgentSessionA (tapi.h)

Artigo
11/20/2024

A função lineCreateAgentSession cria um novo objeto AgentSession. Ele gera uma mensagem LINE_PROXYREQUEST a ser enviada a um manipulador de função proxy registrado, fazendo referência a uma estrutura LINEPROXYREQUEST de do tipo LINEPROXYREQUEST_CREATEAGENTSESSION.

Sintaxe

LONG lineCreateAgentSessionA(
  HLINE           hLine,
  HAGENT          hAgent,
  LPCSTR          lpszAgentPIN,
  DWORD           dwWorkingAddressID,
  LPGUID          lpGroupID,
  LPHAGENTSESSION lphAgentSession
);

Parâmetros

hLine

Manipule para o dispositivo de linha.

hAgent

Identificador do agente para o qual a sessão deve ser criada.

lpszAgentPIN

Ponteiro para um cadeia de caracteres Unicode terminadanulo que contém o PIN ou a senha do agente. Usado ao trabalhar com sistemas ACD herdados que exigem um PIN separado para cada sessão criada (ou grupo conectado). Com um sistema ACD que usa o logon do usuário do sistema operacional para autenticação, lpszAgentPIN está definido como NULL.

dwWorkingAddressID

Identificador do endereço no qual o agente receberá chamadas para esta sessão.

lpGroupID

Ponteiro para um GUID que identifica o grupo para o qual a sessão está sendo criada.

lphAgentSession

Manipule para a sessão de agente criada, retornada pelo proxy ACD. É responsabilidade do aplicativo proxy do manipulador de agente gerar e manter a exclusividade desses identificadores.

Valor de retorno

Retorna um identificador de solicitação se a operação assíncrona for iniciada; caso contrário, a função retornará um dos seguintes valores de erro:

LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Observações

Nota

O cabeçalho tapi.h define lineCreateAgentSession como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

sobre controles de call center

LINEPROXYREQUEST

LINE_PROXYREQUEST

Compartilhar via