Funzione lineRemoveProvider (tapi.h)

Articolo
03/02/2024

La funzione lineRemoveProvider rimuove un provider di servizi di telefonia esistente dal sistema di telefonia.

Sintassi

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

Parametri

dwPermanentProviderID

Identificatore permanente del provider di servizi da rimuovere.

hwndOwner

Handle in una finestra in cui devono essere visualizzate tutte le finestre di dialogo che devono essere visualizzate come parte del processo di rimozione (ad esempio, una finestra di dialogo di conferma in base alla funzione di TSPI_providerRemove del provider di servizi) verrà collegata. Può essere un valore NULL per indicare che qualsiasi finestra creata durante la funzione non deve avere una finestra di proprietario.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM, LINEERR_OPERATIONFAILED.

Commenti

Se la chiamata a TSPI_providerRemove ha esito positivo e il sistema di telefonia è attivo al momento, TAPI chiama lineShutdown e/o phoneShutdown sul provider di servizi (a seconda dei tipi di dispositivo attivi). Eventuali handle di linea o telefono ancora mantenuti dalle applicazioni nei dispositivi associati vengono chiusi forzatamente con messaggi LINE_CLOSE o PHONE_CLOSE (è preferibile che i provider di servizi eseguino questi messaggi come parte di TSPI_providerRemove, dopo la verifica con l'utente). I dispositivi precedentemente sotto il controllo di tale provider vengono quindi contrassegnati come "non disponibili", in modo che eventuali tentativi futuri da parte delle applicazioni di farvi riferimento in base all'identificatore del dispositivo generano LINEERR_NODRIVER.