TSPI_providerInstall, fonction (tspi.h)

Article
08/26/2023

La fonction TSPI_providerInstall est obsolète. Les fournisseurs de services TAPI version 1.4 ou antérieure peuvent implémenter cette fonction TSPI. TapI version 2.0 ou ultérieure implémentent TUISPI_providerInstall.

La fonction TSPI_providerInstall installe toutes les « pièces » supplémentaires du fournisseur dans les répertoires appropriés (ou au moins en vérifiant qu’elles sont bien présentes), configure les entrées de Registre du fournisseur pour ses lignes et téléphones, et crée toutes les autres entrées nécessaires au fournisseur de services. Il est appelé à partir de l’utilitaire téléphonie Panneau de configuration (fourni avec la téléphonie Windows dans les versions 1.4 et antérieures) lorsque vous appuyez sur le bouton Ajouter.

Syntaxe

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Paramètres

hwndOwner

Handle de la fenêtre parente dans laquelle la fonction peut créer toutes les fenêtres de boîte de dialogue requises lors de l’installation.

dwPermanentProviderID

Identificateur permanent du fournisseur de services.

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_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM LINEERR_INVALPARAM.

Remarques

Cette fonction termine l’installation d’autres éléments requis par le fournisseur de services une fois que ses entrées dans la section [Fournisseurs] du Registre ont été effectuées. Si le fournisseur de services a besoin d’entrées supplémentaires définies en privé dans le Registre pour un fonctionnement approprié, elles doivent également être installées. Un moyen classique d’installer cette section avec ses entrées consiste à appeler TSPI_providerConfig.

Cette fonction doit laisser le système dans un état cohérent. Elle doit s’exécuter jusqu’à l’achèvement, ce qui ne permet pas à l’utilisateur d’abandonner l’installation lorsqu’elle est en partie terminée. En cas d’échec de l’installation, il incombe au fournisseur de « revenir en arrière » ce qui a été fait et de retourner une erreur. Cela peut impliquer une analyse préalable pour vérifier qu’une installation complète est possible, avant le début de l’installation.

Cette fonction n’est appelée qu’une seule fois, pendant l’installation du fournisseur de services, jusqu’à ce qu’il y ait un appel à TSPI_providerRemove. Elle doit être appelée avant toute autre fonction définie par TSPI.

L’utilitaire téléphonie Panneau de configuration fourni avec la téléphonie Windows dans les versions 1.4 et antérieures appelle cette fonction (avec les exigences de séquence externe remplies comme décrit ici) lorsque la commande « add » est appelée. Il n’appelle pas TSPI_providerConfig pour la commande « add ».

Il n’existe aucune fonction correspondante au niveau TAPI. À ce niveau, les applications s’attendent à avoir des fournisseurs de services déjà installés. Les applications en cours d’exécution sont informées de la reconfiguration dynamique via la valeur LINEDEVSTATE_REINIT ou PHONESTATE_REINIT dans le message LINE_LINEDEVSTATE ou PHONE_STATE.