Função lineGetAgentInfo (tapi.h)

Artigo
08/26/2023

A função lineGetAgentInfo retorna uma estrutura que contém as informações acd associadas a um identificador de agente específico. 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_GETAGENTINFO.

Sintaxe

LONG lineGetAgentInfo(
  HLINE           hLine,
  HAGENT          hAgent,
  LPLINEAGENTINFO lpAgentInfo
);

Parâmetros

hLine

Manipule para o dispositivo de linha.

hAgent

Identificador do agente cujas informações devem ser recuperadas.

lpAgentInfo

Ponteiro para uma estrutura do tipo LINEAGENTINFO. Se a solicitação for bem-sucedida, essa estrutura será preenchida com as estatísticas do agente.

Valor retornado

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

Antes de chamar a função lineGetAgentInfo , o aplicativo deve definir o membro dwTotalSize da estrutura LINEAGENTINFO para indicar a quantidade de memória disponível para TAPI para retornar informações.