fonction lineGetAddressStatus (tapi.h)

La fonction lineGetAddressStatus permet à une application d’interroger l’adresse spécifiée pour son status actuel.

Syntaxe

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Paramètres

hLine

Gérez vers l’appareil de ligne ouverte.

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.

lpAddressStatus

Pointeur vers une structure de données de taille variable de type LINEADDRESSSTATUS. Avant d’appeler lineGetAddressStatus, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible à TAPI pour retourner des informations.

Note Si les paramètres de taille dans la structure ne sont pas corrects, il est possible que les données soient remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique allocation de mémoire .

 

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_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

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

LINEADDRESSSTATUS

Vue d’ensemble de la référence TAPI 2.2