fonction lineGetAddressID (tapi.h)

Article
03/06/2024

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

Syntaxe

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

Paramètres

hLine

Gérez vers l’appareil de ligne ouverte.

lpdwAddressID

Pointeur vers un emplacement de mémoire de taille DWORD où l’identificateur d’adresse est retourné. 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.

dwAddressMode

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

lpsAddress

Pointeur vers une structure de données contenant l’adresse affectée au périphérique 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 d’appel commun et se termine par une valeur Null.

dwSize

Taille, en octets, de l’adresse contenue dans lpsAddress. La taille de la chaîne doit inclure la marque de fin null.

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

Remarques

La fonction lineGetAddressID permet de mapper un numéro de téléphone (adresse) attribué à un appareil de ligne à son dwAddressID dans la plage zéro au nombre d’adresses moins une retournée dans les 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, 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ù plusieurs adresses sont affectées à une seule ligne.

Note LINEADDRESSMODE_ADDRESSID ne peut pas être utilisé avec lineGetAddressID.