fonction lineGetLineDevStatus (tapi.h)
La fonction lineGetLineDevStatus permet à une application d’interroger le périphérique de ligne ouvert spécifié pour son status actuel.
Syntaxe
LONG lineGetLineDevStatus(
HLINE hLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Paramètres
hLine
Gérez l’appareil de ligne ouverte à interroger.
lpLineDevStatus
Pointeur vers une structure de données de taille variable de type LINEDEVSTATUS. Une fois la demande terminée, cette structure est remplie avec le status de l’appareil de la ligne. Avant d’appeler lineGetLineDevStatus, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible à TAPI pour retourner des informations.
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_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.
Remarques
Une application utilise lineGetLineDevStatus pour interroger le périphérique de ligne pour sa status de ligne actuelle. Ces informations status s’appliquent globalement à toutes les adresses de l’appareil en ligne. Utilisez lineGetAddressStatus pour déterminer status informations sur une adresse spécifique sur une ligne.
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