fonction TSPI_providerShutdown (tspi.h)
La fonction TSPI_providerShutdown arrête le fournisseur de services. Le fournisseur de services met fin à toutes les activités qu’il a en cours et libère les ressources qu’il a allouées.
Syntaxe
LONG TSPIAPI TSPI_providerShutdown(
DWORD dwTSPIVersion,
DWORD dwPermanentProviderID
);
Paramètres
dwTSPIVersion
Version de la définition TSPI sous laquelle cette fonction doit fonctionner. L’appelant peut utiliser TSPI_lineNegotiateTSPIVersion ou TSPI_phoneNegotiateTSPIVersion avec le INITIALIZE_NEGOTIATIONspécial dwDeviceID pour négocier une version qui est acceptable pour le fournisseur de services.
dwPermanentProviderID
Ce paramètre permet au fournisseur de services de déterminer laquelle, parmi plusieurs instances possibles du fournisseur de services, est en cours d’arrêt. La valeur du paramètre est identique à celle passée dans le paramètre du même nom dans TSPI_providerInit.
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_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.
Remarques
Le dernier appel appairé à cette fonction doit être le dernier appel à l’une des fonctions TSPI précédées de TSPI_line ou TSPI_phone autres que TSPI_lineNegotiateTSPIVersion ou TSPI_phoneNegotiateTSPIVersion. Il incombe à l’appelant de s’en assurer.
Cette fonction doit toujours réussir, sauf dans des circonstances extraordinaires. La plupart des appelants ignoreront probablement le code de retour, car ils ne pourront pas compenser une erreur qui se produit. Les valeurs de retour spécifiées sont plus consultatives à des fins de diagnostic de développement que toute autre chose.
Il n’existe aucune fonction correspondant directement dans TAPI. Dans TAPI, plusieurs instances d’utilisation différentes peuvent être en attente, avec un paramètre « handle d’application » pour identifier les instance à utiliser. Dans TSPI, l’architecture d’interface ne prend en charge qu’une seule instance d’utilisation pour chaque fournisseur de services distinct.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |