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