TSPI_lineGetExtensionID, fonction (tspi.h)

La fonction TSPI_lineGetExtensionID retourne l’identificateur d’extension pris en charge par le fournisseur de services pour l’appareil de ligne indiqué.

Syntaxe

LONG TSPIAPI TSPI_lineGetExtensionID(
  DWORD             dwDeviceID,
  DWORD             dwTSPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

Paramètres

dwDeviceID

Périphérique de ligne à interroger.

dwTSPIVersion

Numéro de version de l’interface qui a déjà été négocié pour cet appareil à l’aide de TSPI_lineNegotiateTSPIVersion. Cette fonction fonctionne selon la spécification de l’interface à ce niveau de version.

lpExtensionID

Pointeur vers une structure de type LINEEXTENSIONID. 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. (Par conséquent, un identificateur d’extension valide ne peut pas se composer de tous les zéros.)

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 :

LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL LINEERR_RESOURCEUNAVAIL.

Remarques

Cette fonction est généralement appelée par TAPI en réponse à une application appelant la fonction lineNegotiateAPIVersion . Le résultat retourné par le fournisseur de services doit être approprié pour une utilisation dans un appel ultérieur à TSPI_lineNegotiateExtVersion. Un identificateur d’extension de tous les zéros n’est pas un identificateur d’extension légal, car la valeur de tous les zéros est utilisée pour indiquer que le fournisseur de services ne prend pas en charge les extensions.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tspi.h

Voir aussi

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion