fonction TUISPI_providerInstall (tspi.h)

Article
08/26/2023

L’implémentation de la fonction TUISPI_providerInstall est la possibilité pour le fournisseur de services d’installer toutes les « pièces » supplémentaires du fournisseur dans les répertoires appropriés (ou au moins en vérifiant qu’elles sont là) et de configurer les entrées de Registre dont le fournisseur a besoin. Cette fonction rend la fonction TSPI_providerInstall obsolète dans les versions 2.0 et ultérieures (prises en charge dans les versions 1.4 et antérieures).

Si le fournisseur de services a besoin d’entrées définies en privé dans le Registre pour un bon fonctionnement, elles doivent être installées à ce stade.

L’implémentation est facultative.

Syntaxe

LONG TSPIAPI TUISPI_providerInstall(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

Paramètres

lpfnUIDLLCallback

Pointeur vers une fonction que la DLL d’interface utilisateur peut appeler pour communiquer avec la DLL du fournisseur de services afin d’obtenir les informations nécessaires à l’affichage de la boîte de dialogue.

hwndOwner

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

dwPermanentProviderID

Identificateur de fournisseur 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 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 partiellement terminée. En cas d’échec de l’installation, il incombe au fournisseur de « reculer » 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 peut être appelée plusieurs fois pendant l’installation du fournisseur de services, jusqu’à ce qu’il y ait un appel à TUISPI_providerRemove. Si le fournisseur de services n’a pas besoin ou ne prend pas en charge plusieurs instances du fournisseur, il retourne la LINEERR_ constante LINEERR_NOMULTIPLEINSTANCE.

La fonction correspondante au niveau TAPI est lineAddProvider. Le message LINE_CREATE informe les applications qui s’exécutent sur la reconfiguration dynamique.