Funzione lineRemoveProvider (tapi.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |