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