fonction lineGetLineDevStatus (tapi.h)

Article
03/04/2024

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.