TSPI_lineGetAddressStatus, fonction (tspi.h)
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 |