fonction TSPI_phoneGetExtensionID (tspi.h)

Article
08/26/2023

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.