lineGetAddressIDA, fonction (tapi.h)

La fonction lineGetAddressID retourne l’identificateur d’adresse associé à une adresse dans un autre format sur la ligne spécifiée.

Syntaxe

LONG lineGetAddressIDA(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

Paramètres

hLine

Gérez l’appareil en ligne ouverte.

lpdwAddressID

Pointeur vers un emplacement de mémoire de taille DWORDoù l’identificateur d’adresse est retourné. Un identificateur d’adresse est associé définitivement à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

dwAddressMode

Mode d’adresse de l’adresse contenue dans lpsAddress. Ce paramètre utilise une et une seule des constantes LINEADDRESSMODE_. Vous devez spécifier LINEADDRESSMODE_DIALABLEADDR.

lpsAddress

Pointeur vers une structure de données contenant l’adresse affectée à l’appareil de ligne spécifié. Le format de l’adresse est déterminé par dwAddressMode. Étant donné que la seule valeur valide est LINEADDRESSMODE_DIALABLEADDR, lpsAddress utilise le format de numéro rendez-vous commun et est terminé par null.

dwSize

Taille, en octets, de l’adresse contenue dans lpsAddress. La taille de la chaîne doit inclure le terminateur Null.

Valeur de retour

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_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Remarques

La fonction lineGetAddressID est utilisée pour mapper un numéro de téléphone (adresse) affecté à un appareil de ligne à son dwAddressID dans la plage zéro au nombre d’adresses moins une des fonctionnalités de l’appareil de la ligne. La fonction lineMakeCall permet à l’application d’effectuer un appel en spécifiant un handle de ligne et une adresse sur la ligne. L’adresse peut être spécifiée sous la forme d’un dwAddressID, sous la forme d’un numéro de téléphone ou d’un nom ou d’un identificateur spécifique à l’appareil. L’utilisation d’un numéro de téléphone peut être pratique dans les environnements où une seule ligne est affectée à plusieurs adresses.

Remarque LINEADDRESSMODE_ADDRESSID ne peut pas être utilisée avec lineGetAddressID.

 

Note

L’en-tête tapi.h définit lineGetAddressID comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’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

vue d’ensemble des informations de référence sur TAPI 2.2

lineMakeCall