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 |