funzione TSPI_providerConfig (tspi.h)

Articolo
08/26/2023

La funzione TSPI_providerConfig è obsoleta. I provider di servizi TAPI versione 1.4 o precedenti possono implementare questa funzione TSPI. TAPI versione 2.0 o successiva di TSP implementano TUISPI_providerConfig.

La funzione TSPI_providerConfig raccoglie le informazioni di configurazione dall'utente. Può usare una finestra di dialogo e questa finestra di dialogo può includere finestre di dialogo secondarie associate ad altre API (ad esempio Comm/datamodem) per la configurazione di dispositivi specifici.

Sintassi

LONG TSPIAPI TSPI_providerConfig(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Parametri

hwndOwner

Handle della finestra padre in cui la funzione può creare qualsiasi finestra di dialogo richiesta durante la configurazione.

dwPermanentProviderID

Identificatore permanente del provider di servizi.

Valore restituito

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

LINEERR_OPERATIONFAILED, LINEERR_NOMEM.

Commenti

Questa funzione può essere chiamata mentre il provider di servizi è in uso, ovvero tra chiamate di TSPI_providerInit e TSPI_providerShutdown.

Tutte le modifiche che influiscono sul comportamento visibili tramite TSPI devono essere effettive solo quando il provider di servizi viene riavviato al TSPI_providerInit successivo.

L'utilità Telefonia Pannello di controllo fornita con La telefonia windows nelle versioni 1.4 e versioni precedenti chiama questa funzione quando viene richiamato il comando di installazione.

Non esiste alcuna funzione corrispondente direttamente a livello TAPI. In TAPI le applicazioni hanno accesso alle funzioni lineConfigDialog e phoneConfigDialog, che consentono la configurazione di parametri di una determinata riga o telefono dopo l'installazione.