STRUCTURE LINEADDRESSSTATUS (tapi.h)

Article
03/04/2024

La structure LINEADDRESSSTATUS décrit la status actuelle d’une adresse. La fonction lineGetAddressStatus et la fonction TSPI_lineGetAddressStatus retournent la structure LINEADDRESSSTATUS .

Syntaxe

typedef struct lineaddressstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumInUse;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwAddressFeatures;
  DWORD dwNumRingsNoAnswer;
  DWORD dwForwardNumEntries;
  DWORD dwForwardSize;
  DWORD dwForwardOffset;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
} LINEADDRESSSTATUS, *LPLINEADDRESSSTATUS;

Membres

dwTotalSize

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

dwNeededSize

Taille de cette structure de données nécessaire pour contenir toutes les informations retournées, en octets.

dwUsedSize

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

dwNumInUse

Nombre de stations qui utilisent actuellement l’adresse.

dwNumActiveCalls

Nombre d’appels sur l’adresse qui se trouvent dans des états d’appel autres que inactifs, onholdpendingtransfer et onholdpendingconference.

dwNumOnHoldCalls

Nombre d’appels sur l’adresse dans l’état d’attente .

dwNumOnHoldPendCalls

Nombre d’appels sur l’adresse dans l’état onholdpendingtransfer ou onholdpendingconference .

dwAddressFeatures

Fonctions liées à l’adresse qui peuvent être appelées sur l’adresse dans son état actuel. Ce membre utilise une ou plusieurs constantes LINEADDRFEATURE_.

dwNumRingsNoAnswer

Nombre d’anneaux définis pour cette adresse avant qu’un appel sans réponse ne soit considéré comme une réponse.

dwForwardNumEntries

Nombre d’entrées dans le tableau référencé par dwForwardSize et dwForwardOffset.

dwForwardSize

Taille du tableau d’informations de transfert, en octets.

dwForwardOffset

Décalage entre le début de la structure et le champ de taille variable qui décrit les informations de transfert de l’adresse. Ces informations sont un tableau d’éléments dwForwardNumEntries , de type LINEFORWARD. Les décalages des adresses dans le tableau sont relatifs au début de la structure LINEADDRESSSTATUS . Les décalages dwCallerAddressOffset et dwDestAddressOffset dans le champ de taille variable de type LINEFORWARD pointé vers par dwForwardOffset sont relatifs au début de la structure de données LINEADDRESSSTATUS (le conteneur « racine »). La taille du tableau est spécifiée par dwForwardSize.

dwTerminalModesSize

Taille du tableau de modes terminal, en octets.

dwTerminalModesOffset

Décalage du début de la structure vers le champ d’appareil de taille variable contenant un tableau avec des entrées de taille DWORD, qui utilisent une ou plusieurs constantes LINETERMMODE_. Ce tableau est indexé par des identificateurs de terminal, dans la plage de zéro à un inférieur à dwNumTerminals. Chaque entrée du tableau spécifie les modes de terminal actuels pour l’ensemble de terminaux correspondant avec la fonction lineSetTerminal pour cette adresse. La taille du tableau est spécifiée par dwTerminalModesSize.

dwDevSpecificSize

Taille du champ spécifique à l’appareil, en octets.

dwDevSpecificOffset

Décalage entre le début de cette structure et le champ spécifique de l’appareil de taille variable. La taille du champ est spécifiée par dwDevSpecificSize.

Remarques

Les extensions spécifiques à l’appareil doivent utiliser la zone DevSpecific (dwDevSpecificSize et dwDevSpecificOffset) de taille variable de cette structure de données.

Cette structure de données est retournée par la fonction lineGetAddressStatus . Lorsque des éléments de cette structure de données changent en raison d’activités sur l’adresse, un message LINE_ADDRESSSTATE est envoyé à l’application. Un paramètre de ce message est l’état de l’adresse, l’une des constantes LINEADDRESSSTATE_, qui indique que l’élément status dans cet enregistrement a changé.