fonction TSPI_phoneGetExtensionID (tspi.h)
La fonction TSPI_phoneGetExtensionID récupère l’identificateur d’extension pris en charge par le fournisseur de services pour l’appareil téléphonique indiqué.
Syntaxe
LONG TSPIAPI TSPI_phoneGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPPHONEEXTENSIONID lpExtensionID
);
Paramètres
dwDeviceID
Appareil téléphonique à interroger.
dwTSPIVersion
Spécifie un numéro de version d’interface qui est négocié pour cet appareil à l’aide de TSPI_phoneNegotiateTSPIVersion. Cette fonction fonctionne selon la spécification de l’interface à ce niveau de version.
lpExtensionID
Pointeur vers une structure de type PHONEEXTENSIONID. Si le fournisseur de services prend en charge les extensions spécifiques au fournisseur, il remplit cette structure avec l’identificateur d’extension de ces extensions. Si le fournisseur de services ne prend pas en charge les extensions, il remplit cette structure avec tous les zéros. Un identificateur d’extension de tous les zéros n’est pas un identificateur d’extension légal, car la valeur tous les zéros est utilisée pour indiquer que le fournisseur de services ne prend pas en charge les extensions.
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_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Remarques
Cette fonction est généralement appelée par TAPI en réponse à une application appelant la fonction phoneNegotiateAPIVersion . Le résultat retourné par le fournisseur de services doit être approprié pour une utilisation dans un appel ultérieur à TSPI_phoneNegotiateExtVersion.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |