Compartilhar via

Função lineCreateAgentSessionA (tapi.h)

  • Artigo

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 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 uma cadeia de caracteres Unicode terminada em nulo 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 de usuário do sistema operacional para autenticação, lpszAgentPIN é 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.

Retornar valor

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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

Sobre controles do Call Center

LINEPROXYREQUEST

LINE_PROXYREQUEST