lineGetAddressStatus, fonction (tapi.h)

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

Syntaxe

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

Paramètres

hLine

Gérez l’appareil en ligne ouverte.

dwAddressID

Adresse sur l’appareil de ligne ouverte donné. Il s’agit de l’adresse à interroger. Un identificateur d’adresse est associé définitivement à 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 renvoyer des informations.

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

 

Valeur retournée

Retourne zéro si la requête réussit ou si un numéro d’erreur négatif 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

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