fonction phoneNegotiateAPIVersion (tapi.h)

Article
03/02/2024

PhoneNegotiateAPIVersion permet à une application de négocier une version d’API à utiliser pour l’appareil téléphonique spécifié.

Syntaxe

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

Paramètres

hPhoneApp

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

dwDeviceID

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

dwAPILowVersion

Version d’API la moins récente avec laquelle l’application est conforme. Le mot d’ordre élevé est le numéro de version principal, le mot de bas ordre est le numéro de version secondaire.

dwAPIHighVersion

Version d’API la plus récente avec laquelle l’application est conforme. Le mot d’ordre élevé est le numéro de version principal, le mot de bas ordre est le numéro de version secondaire.

lpdwAPIVersion

Pointeur vers un DWORD dans lequel le numéro de version de l’API qui a été négocié sera retourné. Si la négociation réussit, ce nombre se trouve dans la plage dwAPILowVersion à dwAPIHighVersion.

lpExtensionID

Pointeur vers une structure de type PHONEEXTENSIONID. Si le fournisseur de services pour le paramètre dwDeviceID spécifié prend en charge les extensions spécifiques au fournisseur, cette structure est remplie avec l’identificateur d’extension de ces extensions lorsque la négociation aboutit. Cette structure contient tous les zéros si la ligne ne fournit aucune extension. Une application peut ignorer le paramètre retourné si elle n’utilise pas d’extensions.

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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Remarques

La fonction phoneNegotiateAPIVersion est utilisée pour négocier le numéro de version de l’API à utiliser avec l’appareil téléphonique spécifié. 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.

Si l’application souhaite utiliser 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 de l’API négocié est celui sous lequel TAPI peut fonctionner. Si les plages de versions ne se chevauchent pas, les versions de l’application, de l’API ou du fournisseur de services sont incompatibles et une erreur est retournée.