TSPI_lineGetAddressStatus, fonction (tspi.h)

  • Article

La fonction TSPI_lineGetAddressStatus interroge l’adresse spécifiée pour son status actuel.

Syntaxe

LONG TSPIAPI TSPI_lineGetAddressStatus(
  HDRVLINE            hdLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Paramètres

hdLine

Handle du fournisseur de services sur la ligne contenant l’adresse à interroger.

dwAddressID

Adresse sur l’appareil de ligne ouverte donné. Il s’agit de l’adresse à interroger. Un identificateur d’adresse est associé de manière permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation. Ce paramètre n’est pas validé par TAPI lorsque cette fonction est appelée.

lpAddressStatus

Pointeur vers une structure de données de taille variable de type LINEADDRESSSTATUS.

Valeur retournée

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Remarques

Le fournisseur de services remplit tous les membres de la structure de données LINEADDRESSSTATUS , à l’exception de dwTotalSize, qui est renseigné par TAPI. Le fournisseur de services ne doit pas remplacer le membre dwTotalSize .

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tspi.h

Voir aussi

LINEADDRESSSTATUS