fonction phoneNegotiateExtVersion (tapi.h)

Article
08/26/2023

La fonction phoneNegotiateExtVersion permet à une application de négocier une version d’extension à utiliser avec l’appareil téléphonique 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 phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

Paramètres

hPhoneApp

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

dwDeviceID

Identificateur de l’appareil téléphonique à interroger.

dwAPIVersion

Numéro de version de l’API qui a été négocié pour l’appareil téléphonique spécifié à l’aide de phoneNegotiateAPIVersion.

dwExtLowVersion

Version d’extension la moins récente de l’identificateur d’extension retourné par phoneNegotiateAPIVersion 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

Version d’extension la plus récente de l’identificateur d’extension retourné par phoneNegotiateAPIVersion 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 un DWORD dans lequel le numéro de version d’extension qui a été négocié est retourné. Si la négociation réussit, ce nombre se trouve dans la plage dwExtLowVersion à 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 :

PHONEERR_INVALAPPHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NODRIVER, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER, PHONEERR_NODEVICE.

Remarques

La fonction phoneNegotiateExtVersion est utilisée pour négocier le numéro de version de l’API à utiliser. Il retourne l’identificateur d’extension pris en charge par l’appareil téléphonique, ou des zéros si aucune extension n’est fournie.

Pour que l’application utilise les extensions définies par l’identificateur d’extension retourné, elle doit appeler phoneNegotiateExtVersion pour négocier la version de l’extension à utiliser.

Utilisez phoneInitializeEx pour déterminer le nombre d’appareils téléphoniques présents dans le système. L’identificateur d’appareil spécifié par dwDeviceID varie de zéro à un de moins que le nombre d’appareils téléphoniques présents.

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.