Função lineGetAgentCapsA (tapi.h)

Artigo
08/26/2023

A função lineGetAgentCaps obtém os recursos relacionados ao agente com suporte no dispositivo de linha especificado. Se um agente específico for nomeado, os recursos incluirão uma listagem de grupos ACD nos quais o agente tem permissão para fazer logon.

Sintaxe

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Parâmetros

hLineApp

Manipule para o registro do aplicativo com TAPI.

dwDeviceID

Dispositivo de linha que contém o endereço a ser consultado.

dwAddressID

Endereço no dispositivo de linha determinado cujos recursos devem ser consultados. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

dwAppAPIVersion

Versão de API mais alta com suporte do aplicativo. Esse não deve ser o valor negociado usando lineNegotiateAPIVersion no dispositivo que está sendo consultado.

lpAgentCaps

Ponteiro para uma estrutura de tamanho variavelmente do tipo LINEAGENTCAPS. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações de funcionalidades do agente. Antes de chamar lineGetAgentCaps, o aplicativo deve definir o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Valor retornado

Retorna um identificador de solicitação positivo se a operação assíncrona for iniciada; caso contrário, essa função retornará um destes valores de erro negativos:

LINEERR_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Comentários

Observação

O cabeçalho tapi.h define lineGetAgentCaps 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.