Função lineGetAgentCapsA (tapi.h)

Artigo
11/20/2024

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 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 em 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 dwTotalSize membro dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Valor de retorno

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.

Observações

Nota

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

LINEAGENTCAPS

Funções de serviço de linha suplementar

visão geral de referência do TAPI 2.2

lineNegotiateAPIVersion

Compartilhar via