fonction lineSetStatusMessages (tapi.h)

Article
03/02/2024

La fonction lineSetStatusMessages permet à une application de spécifier les messages de notification à recevoir pour les événements liés à status modifications pour la ligne spécifiée ou l’une de ses adresses.

Syntaxe

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

Paramètres

hLine

Gérez l’appareil de ligne.

dwLineStates

Tableau de bits qui identifie le status de périphérique de ligne qui modifie un message doit être envoyé à l’application. Ce paramètre utilise une ou plusieurs constantes LINEDEVSTATE_.

dwAddressStates

Tableau de bits qui identifie l’adresse status modifie un message doit être envoyé à l’application. Ce paramètre utilise une ou plusieurs constantes LINEADDRESSSTATE_.

Valeur retournée

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

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL.

Remarques

TAPI définit un certain nombre de messages qui informent les applications des événements qui se produisent sur les lignes et les adresses. Une application peut ne pas être 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 reçoit. Par défaut, les rapports d’adresse et de ligne status sont désactivés.