Compartilhar via

Função lineCreateAgentA (tapi.h)

  • Artigo

A função lineCreateAgent cria um novo objeto Agent. 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_CREATEAGENT.

Sintaxe

LONG lineCreateAgentA(
  HLINE    hLine,
  LPCSTR   lpszAgentID,
  LPCSTR   lpszAgentPIN,
  LPHAGENT lphAgent
);

Parâmetros

hLine

Identificador para o dispositivo de linha.

lpszAgentID

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o identificador do agente. Usado ao trabalhar com sistemas ACD herdados. Com um sistema ACD que usa o logon de usuário do sistema operacional para autenticação, lpszAgentID é definido como NULL.

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. Com um sistema ACD que usa o logon de usuário do sistema operacional para autenticação, lpszAgentPIN é definido como NULL.

lphAgent

Identificador para o agente criado, retornado pelo proxy ACD. É responsabilidade do aplicativo proxy do manipulador de agente gerar e manter a exclusividade desse identificador.

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 lineCreateAgent 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

LINEPROXYREQUEST

LINE_PROXYREQUEST