fonction lineRemoveProvider (tapi.h)

Article
08/26/2023

La fonction lineRemoveProvider supprime un fournisseur de services de téléphonie existant du système de téléphonie.

Syntaxe

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

Paramètres

dwPermanentProviderID

Identificateur de fournisseur permanent du fournisseur de services à supprimer.

hwndOwner

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

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_NOMEM, LINEERR_INVALPARAM, LINEERR_OPERATIONFAILED.

Remarques

Si l’appel à TSPI_providerRemove réussit et que le système de téléphonie est actif à ce moment-là, TAPI appelle lineShutdown et/ou phoneShutdown sur le fournisseur de services (selon les types d’appareils actifs). Tous les handles de ligne ou de téléphone toujours détenus par les applications sur les appareils associés sont fermés de force avec des messages LINE_CLOSE ou PHONE_CLOSE (il est préférable pour les fournisseurs de services d’émettre ces messages dans le cadre de TSPI_providerRemove, après vérification avec l’utilisateur). Les appareils précédemment sous le contrôle de ce fournisseur sont ensuite marqués comme « indisponibles », de sorte que toutes les tentatives ultérieures d’applications de les référencer par identificateur d’appareil entraînent des LINEERR_NODRIVER.