Partager via


fonction lineSetStatusMessages (tapi.h)

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.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

Informations de référence sur les services de téléphonie de base

LINE_CLOSE

LINE_LINEDEVSTATE

Vue d’ensemble de la référence TAPI 2.2

lineInitialize

lineInitializeEx

lineOpen