Structure LINEAGENTCAPS (tapi.h)

Article
08/26/2023

La structure LINEAGENTCAPS décrit les fonctionnalités d’un agent ACD. La fonction lineGetAgentCaps retourne la structure LINEAGENTCAPS .

Syntaxe

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;

Membres

dwTotalSize

Taille totale allouée à cette structure de données, en octets.

dwNeededSize

Taille nécessaire pour contenir toutes les informations demandées, en octets.

dwUsedSize

Taille de la partie de cette structure de données qui contient des informations utiles, en octets.

dwAgentHandlerInfoSize

Taille des informations de gestionnaire d’agent, en octets.

dwAgentHandlerInfoOffset

Décalage du début de la structure vers une chaîne terminée par un caractère Null spécifiant le nom, la version ou d’autres informations d’identification de l’application serveur qui gère les demandes d’agent. La taille de la chaîne est spécifiée par dwAgentHandlerInfoSize.

dwCapsVersion

Version TAPI utilisée par l’application de gestionnaire d’agent pour préparer le contenu de cette structure. Cette valeur n’est pas supérieure à la version de l’API que l’application appelante a transmise à lineGetAgentCaps.

dwFeatures

Fonctionnalités liées à l’agent disponibles pour cette ligne à l’aide des constantes LINEAGENTFEATURE_. L’appel d’une fonctionnalité prise en charge nécessite que la ligne et l’adresse soient dans l’état approprié. Un zéro en position de bit indique que la fonctionnalité correspondante n’est jamais disponible. Un indique que la fonctionnalité correspondante peut être disponible si la ligne est dans l’état approprié pour que l’opération soit significative. Ce champ permet à une application de découvrir quelles fonctionnalités d’agent peuvent être (et qui ne peuvent jamais être) prises en charge par l’appareil.

dwStates

LINEAGENTSTATE_ constantes qui peuvent être utilisées dans le paramètre dwAgentState de lineSetAgentState. La définition d’un état pris en charge nécessite que la ligne et l’adresse soient dans l’état approprié. Un zéro en position de bit indique que l’état correspondant n’est jamais disponible. Un indique que l’état correspondant peut être disponible si la ligne est dans l’état approprié pour que l’état soit significatif. Ce champ permet à une application de découvrir quels états d’agent peuvent être (et qui ne peuvent jamais être) pris en charge sur l’appareil.

dwNextStates

LINEAGENTSTATE_ constantes qui peuvent être utilisées dans le paramètre dwNextAgentState de lineSetAgentState. La définition d’un état pris en charge nécessite que la ligne et l’adresse soient dans l’état approprié. Un zéro en position de bit indique que l’état correspondant n’est jamais disponible. Un indique que l’état correspondant peut être disponible si la ligne est dans l’état approprié pour que l’état soit significatif. Ce champ permet à une application de découvrir quels états d’agent peuvent être (et qui ne peuvent jamais être) pris en charge sur l’appareil.

dwMaxNumGroupEntries

Nombre maximal d’identificateurs d’agent pouvant être connectés simultanément sur l’adresse. Détermine la valeur la plus élevée qui peut être passée en tant que membre dwNumEntries dans la structure LINEAGENTGROUPLIST à lineSetAgentGroup.

dwAgentStatusMessages

Indique les constantes LINEAGENTSTATUS_ qui peuvent être reçues par l’application dans dwParam2 d’un message LINE_AGENTSTATUS .

dwNumAgentExtensionIDs

Nombre de structures LINEEXTENSIONID qui apparaissent dans le tableau ExtensionIDList . La valeur est 0 si les extensions spécifiques à l’agent-gestionnaire sont prises en charge sur l’adresse.

dwAgentExtensionIDListSize

Taille du tableau d’ID d’extension de l’agent, en octets.

dwAgentExtensionIDListOffset

Décalage du début de la structure vers un tableau de structures LINEEXTENSIONID . La taille est dwNumExtensionIDs fois SIZEOF(LINEEXTENSIONID). Le tableau répertorie les identificateurs 128 bits universels uniques pour toutes les extensions spécifiques au gestionnaire d’agent prises en charge par le handle d’agent pour l’adresse. L’extension utilisée est référencée dans la fonction lineAgentSpecific et LINE_AGENTSPECIFIC message par sa position dans cette table, la première entrée étant l’entrée 0. Il est donc important que le gestionnaire d’agent présente toujours les identificateurs d’extension dans ce tableau dans le même ordre. La taille du tableau est spécifiée par dwAgentExtensionIDListOffset.

ProxyGUID

GUID pour le proxy ACD associé à la ligne. Cet élément est exposé uniquement aux applications qui négocient une version TAPI 2.2 ou ultérieure.