fonction TSPI_lineGetAddressID (tspi.h)
La fonction TSPI_lineGetAddressID retourne l’identificateur d’adresse associé à l’adresse dans un autre format sur la ligne spécifiée.
Syntaxe
LONG TSPIAPI TSPI_lineGetAddressID(
HDRVLINE hdLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCWSTR lpsAddress,
DWORD dwSize
);
Paramètres
hdLine
Handle du fournisseur de services sur la ligne dont l’adresse doit être récupérée.
lpdwAddressID
Pointeur vers un emplacement de mémoire de taille DWORD où l’identificateur d’adresse est retourné.
dwAddressMode
Mode d’adresse de l’adresse contenue dans lpsAddress. Le paramètre dwAddressMode est autorisé à avoir une seule constante LINEADDRESSMODE_.
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 le paramètre dwAddressMode . S’il est LINEADDRESSMODE_DIALABLEADDR, le paramètre lpsAddress utilise le format de numéro de numérotation commun et a la valeur NULL terminée.
dwSize
Taille de l’adresse contenue dans lpsAddress. Le paramètre dwSize doit être défini sur la longueur de la chaîne (plus un pour la valeur NULL) si LINEADDRESSMODE_DIALABLEADDR est utilisé. Si un LINEADDRESSMODE étendu est utilisé, la longueur doit correspondre à la taille de ce qui est réellement transmis (la DLL vérifie qu’elle peut lire le nombre d’octets spécifié à partir du pointeur donné).
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_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Remarques
Cette fonction est utilisée pour mapper un numéro de téléphone (adresse) attribué à un appareil de ligne à son dwAddressID (entre 0 et le nombre d’adresses moins un) retourné dans les fonctionnalités de l’appareil de la ligne.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |