fonction lineNegotiateExtVersion (tapi.h)

Article
03/02/2024

La fonction lineNegotiateExtVersion permet à une application de négocier une version d’extension à utiliser avec l’appareil de ligne spécifié. Cette opération n’a pas besoin d’être appelée si l’application ne prend pas en charge les extensions.

Syntaxe

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

Paramètres

hLineApp

Gérez l’inscription de l’application avec TAPI.

dwDeviceID

Identificateur de l’appareil de ligne à interroger.

dwAPIVersion

Numéro de version TAPI qui a été négocié pour l’appareil de ligne spécifié à l’aide de lineNegotiateAPIVersion.

dwExtLowVersion

Version d’extension la plus ancienne de l’identificateur d’extension retourné par lineNegotiateAPIVersion avec laquelle l’application est conforme. Le mot d’ordre élevé est le numéro de version principal ; le mot de faible ordre est le numéro de version secondaire.

dwExtHighVersion

Dernière version d’extension de l’identificateur d’extension retourné par lineNegotiateAPIVersion avec laquelle l’application est conforme. Le mot d’ordre élevé est le numéro de version principal ; le mot de faible ordre est le numéro de version secondaire.

lpdwExtVersion

Pointeur vers une variable qui contient le numéro de version de l’extension qui a été négocié. Si la négociation réussit, ce nombre se situe dans la plage entre dwExtLowVersion et dwExtHighVersion.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODEVICE, LINEERR_OPERATIONUNAVAIL.

Remarques

Utilisez lineInitializeEx pour déterminer le nombre d’appareils de ligne présents dans le système. L’identificateur d’appareil spécifié par dwDeviceID varie de zéro à un inférieur au nombre d’appareils de ligne présents.

La fonction lineNegotiateAPIVersion négocie le numéro de version de l’API à utiliser. Il récupère également l’identificateur d’extension pris en charge par l’appareil de ligne, qui est zéro si aucune extension n’est fournie. Les numéros de version doivent être incrémentés d’un pour chaque version. Le fait de laisser des lacunes dans la numérotation des versions peut entraîner des résultats inattendus.

Si l’application souhaite utiliser les extensions définies par l’identificateur d’extension retourné, elle doit appeler lineNegotiateExtVersion pour négocier la version de l’extension à utiliser.

Le numéro de version d’extension négocié est celui sous lequel l’application et le fournisseur de services doivent tous deux fonctionner. Si les plages de versions ne se chevauchent pas, les versions de l’application et du fournisseur de services sont incompatibles et une erreur est retournée.