Função lineCreateAgentA (tapi.h)

Artigo
11/20/2024

A função lineCreateAgent cria um novo objeto Agent. Ele gera uma mensagem de 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

Manipule para o dispositivo de linha.

lpszAgentID

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

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

lphAgent

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

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

LINEPROXYREQUEST

LINE_PROXYREQUEST

Compartilhar via