funzione lineAddProvider (tapi.h)

Articolo
08/26/2023

La funzione lineAddProvider installa un nuovo provider di servizi di telefonia nel sistema di telefonia.

Sintassi

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

Parametri

lpszProviderFilename

Puntatore a un oggetto

Stringa con terminazione null contenente il percorso del provider di servizi da aggiungere.

hwndOwner

Gestire una finestra in cui verranno associate tutte le finestre di dialogo che devono essere visualizzate come parte del processo di installazione, ad esempio dalla funzione TSPI_providerInstall del provider di servizi. Può essere NULL per indicare che qualsiasi finestra creata durante la funzione non deve avere alcuna finestra proprietario.

lpdwPermanentProviderID

Puntatore a una variabile che riceve l'identificatore del provider di servizi appena installato.

Valore restituito

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

LINEERR_INIFILECORRUPT, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE, LINEERR_OPERATIONFAILED.

Commenti

Durante questa chiamata alla funzione, TAPI verifica che possa accedere al provider di servizi chiamando la sua funzione TSPI_providerInstall ; se non è possibile trovare la DLL o la funzione o se TSPI_providerInstall restituisce un errore, la funzione non riesce e il provider non viene aggiunto al sistema di telefonia. In caso di esito positivo e il sistema di telefonia è attivo (una o più applicazioni hanno chiamato lineInitialize o lineInitializeEx), TAPI non tenta di avviare il provider di servizi appena aggiunto. Al contrario, per attivare il nuovo provider di servizi, TAPI invia un messaggio per riavviare Windows. Quando l'attivazione ha esito positivo, le applicazioni vengono informate di eventuali nuovi dispositivi creati tramite LINE_CREATE o PHONE_CREATE messaggi oppure da un messaggio di LINE_LINEDEVSTATE che richiede la reinizializzazione (se l'applicazione non supporta i messaggi CREATE).

Questa funzione copia nessun file, non la DLL del provider di servizi stessa né i file di supporto; l'applicazione che gestisce l'aggiunta del provider deve assicurarsi che il provider sia installato in una directory in cui può essere trovato da TAPI ,ad esempio \WINDOWS, \WINDOWS\SYSTEM o altrove nel percorso.