Estructura LINEAGENTCAPS (tapi.h)

Artículo
08/26/2023

La estructura LINEAGENTCAPS describe las funciones de un agente de ACD. La función lineGetAgentCaps devuelve la estructura LINEAGENTCAPS .

Sintaxis

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;

Miembros

dwTotalSize

Tamaño total asignado a esta estructura de datos, en bytes.

dwNeededSize

Tamaño necesario para contener toda la información solicitada, en bytes.

dwUsedSize

Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.

dwAgentHandlerInfoSize

Tamaño de la información del controlador del agente, en bytes.

dwAgentHandlerInfoOffset

Desfase desde el principio de la estructura a una cadena terminada en null que especifica el nombre, la versión u otra información de identificación de la aplicación de servidor que controla las solicitudes del agente. DwAgentHandlerInfoSize especifica el tamaño de la cadena.

dwCapsVersion

Versión de TAPI que la aplicación de controlador de agente usó para preparar el contenido de esta estructura. Esto no es mayor que la versión de la API que la aplicación que realiza la llamada pasó a lineGetAgentCaps.

dwFeatures

Características relacionadas con el agente disponibles para esta línea mediante las constantes LINEAGENTFEATURE_. La invocación de una característica admitida requiere que la línea y la dirección estén en el estado adecuado. Un cero en una posición de bits indica que la característica correspondiente nunca está disponible. Una indica que la característica correspondiente puede estar disponible si la línea está en el estado adecuado para que la operación sea significativa. Este campo permite a una aplicación detectar qué características de agente pueden ser (y que nunca pueden ser) compatibles con el dispositivo.

dwStates

LINEAGENTSTATE_ constantes que se pueden usar en el parámetro dwAgentState de lineSetAgentState. Establecer un estado admitido requiere que la línea y la dirección estén en el estado adecuado. Un cero en una posición de bits indica que el estado correspondiente nunca está disponible. Una indica que el estado correspondiente puede estar disponible si la línea está en el estado adecuado para que el estado sea significativo. Este campo permite a una aplicación detectar qué estados de agente pueden ser (y que nunca se pueden admitir) en el dispositivo.

dwNextStates

LINEAGENTSTATE_ constantes que se pueden usar en el parámetro dwNextAgentState de lineSetAgentState. Establecer un estado admitido requiere que la línea y la dirección estén en el estado adecuado. Un cero en una posición de bits indica que el estado correspondiente nunca está disponible. Una indica que el estado correspondiente puede estar disponible si la línea está en el estado adecuado para que el estado sea significativo. Este campo permite a una aplicación detectar qué estados de agente pueden ser (y que nunca se pueden admitir) en el dispositivo.

dwMaxNumGroupEntries

Número máximo de identificadores de agente que se pueden iniciar sesión en la dirección simultáneamente. Determina el valor más alto que se puede pasar como miembro dwNumEntries de la estructura LINEAGENTGROUPLIST a lineSetAgentAgentGroup.

dwAgentStatusMessages

Indica las constantes LINEAGENTSTATUS_ que la aplicación puede recibir en dwParam2 de un mensaje de LINE_AGENTSTATUS .

dwNumAgentExtensionIDs

Número de estructuras LINEEXTENSIONID que aparecen en la matriz ExtensionIDList . El valor es 0 si se admiten extensiones específicas del controlador de agente en la dirección.

dwAgentExtensionIDListSize

Tamaño de la matriz de identificadores de extensión del agente, en bytes.

dwAgentExtensionIDListOffset

Desfase desde el principio de la estructura a una matriz de estructuras LINEEXTENSIONID . El tamaño es dwNumExtensionIDs veces SIZEOF(LINEEXTENSIONID). La matriz enumera los identificadores universalmente únicos de 128 bits para todas las extensiones específicas del controlador de agente admitidas por el identificador del agente para la dirección. La extensión que se usa se hace referencia a la función lineAgentSpecific y LINE_AGENTSPECIFIC mensaje por su posición en esta tabla, la primera entrada es la entrada 0, por lo que es importante que el controlador del agente siempre presente identificadores de extensión en esta matriz en el mismo orden. El tamaño de la matriz se especifica mediante dwAgentExtensionIDListOffset.

ProxyGUID

GUID del proxy de ACD asociado a la línea. Este elemento solo se expone a las aplicaciones que negocian una versión TAPI de 2.2 o superior.