TSPI_phoneSelectExtVersion, fonction (tspi.h)
La fonction TSPI_phoneSelectExtVersion sélectionne la version d’extension indiquée pour l’appareil téléphonique indiqué. Les requêtes suivantes fonctionnent selon cette version d’extension.
Syntaxe
LONG TSPIAPI TSPI_phoneSelectExtVersion(
HDRVPHONE hdPhone,
DWORD dwExtVersion
);
Paramètres
hdPhone
Handle du téléphone pour lequel une version d’extension doit être sélectionnée.
dwExtVersion
Version de l’extension à sélectionner. Ce numéro de version est négocié à l’aide de TSPI_phoneNegotiateExtVersion. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version mineure. L’appel de cette fonction avec une valeur dwExtVersion égale à zéro annule la sélection actuelle.
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 :
PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Remarques
Cette fonction sélectionne la version d’extension indiquée. Bien que le numéro de version indiqué ait pu être négocié avec succès, une autre version d’extension a peut-être été sélectionnée entre-temps, auquel cas cette fonction échoue (renvoyant PHONEERR_INCOMPATIBLEEXTVERSION).
Les opérations suivantes sur le téléphone après la sélection d’une version d’extension se comportent en fonction de cette version d’extension. Les tentatives suivantes de négociation de la version de l’extension rapportent strictement la version sélectionnée ou zéro (si la plage demandée n’inclut pas la version sélectionnée). L’appel de cette procédure avec l’extension spéciale version 0 annule la sélection actuelle. L’appareil redevient capable de prendre en charge toute sa gamme de numéros de version d’extension.
TSPI_phoneSelectExtVersion est généralement appelée dans deux situations : (1) Une application a demandé à ouvrir un téléphone, l’application a demandé qu’une version d’extension particulière soit utilisée et aucune version d’extension n’a été sélectionnée actuellement ; ou (2) la dernière application utilisant une version d’extension particulière a fermé le téléphone et la sélection de la version d’extension peut être annulée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |