fonction phoneNegotiateExtVersion (tapi.h)
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.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | tapi.h |
Bibliothèque | Tapi32.lib |
DLL | Tapi32.dll |
Voir aussi
Informations de référence sur les services de téléphonie étendus