fonction lineGetStatusMessages (tapi.h)

Article
03/02/2024

La fonction lineGetStatusMessages permet à une application d’interroger les messages de notification que l’application est configurée pour recevoir pour les événements liés à status modifications pour la ligne spécifiée ou l’une de ses adresses.

Syntaxe

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

Paramètres

hLine

Gérez l’appareil de ligne.

lpdwLineStates

Tableau de bits qui identifie pour quel appareil de ligne status modifie un message doit être envoyé à l’application. Si un indicateur a la valeur TRUE, ce message est activé ; si la valeur est FALSE, elle est désactivée. Ce paramètre utilise une ou plusieurs constantes LINEDEVSTATE_.

lpdwAddressStates

Tableau de bits qui identifie pour quelle adresse status modifie un message doit être envoyé à l’application. Si un indicateur a la valeur TRUE, ce message est activé ; si la valeur est FALSE, désactivée. Ce paramètre utilise une ou plusieurs constantes LINEADDRESSSTATE_.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Remarques

TAPI définit un certain nombre de messages qui informent les applications des événements se produisant sur les lignes et les adresses. Une application n’est peut-être pas intéressée par la réception de tous les messages d’adresse et de ligne status de modification. La fonction lineSetStatusMessages peut être utilisée pour sélectionner les messages que l’application souhaite recevoir. Par défaut, les rapports de status d’adresse et de ligne status sont désactivés.