fonction lineAddProvider (tapi.h)

Article
08/26/2023

La fonction lineAddProvider installe un nouveau fournisseur de services de téléphonie dans le système de téléphonie.

Syntaxe

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

Paramètres

lpszProviderFilename

Pointeur vers un

Chaîne terminée par null contenant le chemin d’accès du fournisseur de services à ajouter.

hwndOwner

Gérez une fenêtre dans laquelle toutes les boîtes de dialogue qui doivent être affichées dans le cadre du processus d’installation (par exemple, par la fonction TSPI_providerInstall du fournisseur de services) sont attachées. Peut être NULL pour indiquer que toute fenêtre créée pendant la fonction ne doit avoir aucune fenêtre propriétaire.

lpdwPermanentProviderID

Pointeur vers une variable qui reçoit l’identificateur de fournisseur permanent du fournisseur de services nouvellement installé.

Valeur retournée

Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INIFILECORRUPT, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE LINEERR_OPERATIONFAILED.

Remarques

Pendant cet appel de fonction, TAPI vérifie qu’il peut accéder au fournisseur de services en appelant sa fonction TSPI_providerInstall ; en cas d’échec (si la DLL ou la fonction est introuvable, ou si TSPI_providerInstall retourne une erreur), la fonction échoue et le fournisseur n’est pas ajouté au système de téléphonie. Si cela réussit et que le système de téléphonie est actif (une ou plusieurs applications ont appelé lineInitialize ou lineInitializeEx), TAPI ne tente pas de lancer le fournisseur de services nouvellement ajouté. Au lieu de cela, pour activer le nouveau fournisseur de services, TAPI émet un message pour redémarrer Windows. Lorsque l’activation réussit, les applications sont informées de tout nouvel appareil créé par le biais de messages LINE_CREATE ou PHONE_CREATE , ou par un message LINE_LINEDEVSTATE demandant la réinitialisation (si l’application ne prend pas en charge les messages CREATE).

Cette fonction ne copie aucun fichier, pas la DLL du fournisseur de services elle-même, ni les fichiers de prise en charge ; L’application qui gère l’ajout du fournisseur doit s’assurer que le fournisseur est installé dans un répertoire où il peut être trouvé par TAPI (par exemple, \WINDOWS, \WINDOWS\SYSTEM ou ailleurs sur le chemin d’accès).