Função lineCreateAgentSessionA (tapi.h)
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 |