Estrutura LINEAGENTCAPS (tapi.h)

Artigo
08/26/2023

A estrutura LINEAGENTCAPS descreve os recursos de um agente ACD. A função lineGetAgentCaps retorna a estrutura LINEAGENTCAPS .

Sintaxe

typedef struct lineagentcaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwAgentHandlerInfoSize;
  DWORD dwAgentHandlerInfoOffset;
  DWORD dwCapsVersion;
  DWORD dwFeatures;
  DWORD dwStates;
  DWORD dwNextStates;
  DWORD dwMaxNumGroupEntries;
  DWORD dwAgentStatusMessages;
  DWORD dwNumAgentExtensionIDs;
  DWORD dwAgentExtensionIDListSize;
  DWORD dwAgentExtensionIDListOffset;
  GUID  ProxyGUID;
} LINEAGENTCAPS, *LPLINEAGENTCAPS;

Membros

dwTotalSize

Tamanho total alocado para essa estrutura de dados, em bytes.

dwNeededSize

Tamanho necessário para manter todas as informações solicitadas, em bytes.

dwUsedSize

Tamanho da parte dessa estrutura de dados que contém informações úteis, em bytes.

dwAgentHandlerInfoSize

Tamanho das informações do manipulador do agente, em bytes.

dwAgentHandlerInfoOffset

Deslocamento do início da estrutura para uma cadeia de caracteres terminada em nulo especificando o nome, a versão ou outras informações de identificação do aplicativo de servidor que está tratando solicitações do agente. O tamanho da cadeia de caracteres é especificado por dwAgentHandlerInfoSize.

dwCapsVersion

Versão tapi que o aplicativo manipulador de agente usou na preparação do conteúdo dessa estrutura. Isso não é maior do que a versão da API que o aplicativo de chamada passou para lineGetAgentCaps.

dwFeatures

Recursos relacionados ao agente disponíveis para essa linha usando as constantes LINEAGENTFEATURE_. Invocar um recurso com suporte requer que a linha e o endereço estejam no estado adequado. Um zero em uma posição de bit indica que o recurso correspondente nunca está disponível. Um indica que o recurso correspondente poderá estar disponível se a linha estiver no estado apropriado para que a operação seja significativa. Esse campo permite que um aplicativo descubra quais recursos do agente podem ser (e quais nunca podem ser) compatíveis com o dispositivo.

dwStates

LINEAGENTSTATE_ constantes que podem ser usadas no parâmetro dwAgentState de lineSetAgentState. Definir um estado com suporte requer que a linha e o endereço estejam no estado adequado. Um zero em uma posição de bit indica que o estado correspondente nunca está disponível. Um indica que o estado correspondente pode estar disponível se a linha estiver no estado apropriado para que o estado seja significativo. Esse campo permite que um aplicativo descubra quais estados de agente podem ser (e quais nunca podem ser) compatíveis com o dispositivo.

dwNextStates

LINEAGENTSTATE_ constantes que podem ser usadas no parâmetro dwNextAgentState de lineSetAgentState. Definir um estado com suporte requer que a linha e o endereço estejam no estado adequado. Um zero em uma posição de bit indica que o estado correspondente nunca está disponível. Um indica que o estado correspondente pode estar disponível se a linha estiver no estado apropriado para que o estado seja significativo. Esse campo permite que um aplicativo descubra quais estados de agente podem ser (e quais nunca podem ser) compatíveis com o dispositivo.

dwMaxNumGroupEntries

Número máximo de identificadores de agente que podem ser conectados no endereço simultaneamente. Determina o valor mais alto que pode ser passado como o membro dwNumEntries na estrutura LINEAGENTGROUPLIST para lineSetAgentGroup.

dwAgentStatusMessages

Indica as constantes LINEAGENTSTATUS_ que podem ser recebidas pelo aplicativo em dwParam2 de uma mensagem LINE_AGENTSTATUS .

dwNumAgentExtensionIDs

Número de estruturas LINEEXTENSIONID que aparecem na matriz ExtensionIDList . O valor será 0 se houver suporte para extensões específicas do manipulador de agente no endereço.

dwAgentExtensionIDListSize

Tamanho da matriz de IDs de extensão do agente, em bytes.

dwAgentExtensionIDListOffset

Deslocamento do início da estrutura para uma matriz de estruturas LINEEXTENSIONID . O tamanho é dwNumExtensionIDs times SIZEOF(LINEEXTENSIONID). A matriz lista os identificadores universalmente exclusivos de 128 bits para todas as extensões específicas do manipulador de agente compatíveis com o identificador do agente para o endereço. A extensão que está sendo usada é referenciada na função lineAgentSpecific e LINE_AGENTSPECIFIC mensagem por sua posição nesta tabela, sendo a primeira entrada a entrada 0, portanto, é importante que o manipulador de agente sempre apresente identificadores de extensão nessa matriz na mesma ordem. O tamanho da matriz é especificado por dwAgentExtensionIDListOffset.

ProxyGUID

GUID para proxy ACD associado à linha. Esse elemento é exposto somente a aplicativos que negociam uma versão TAPI 2.2 ou superior.