funzione TUISPI_providerConfig (tspi.h)

Articolo
03/03/2024

La funzione TUISPI_providerConfig implementa gli elementi dell'interfaccia utente che devono essere eseguiti nel contesto dell'applicazione chiamante. Questa funzione rende obsoleta la funzione TSPI_providerConfig nella versione 2.0 e successive (supportata nella versione 1.4 e precedenti).

La funzione TUISPI_providerConfig raccoglie 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.

L'implementazione è facoltativa.

Sintassi

LONG TSPIAPI TUISPI_providerConfig(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

Parametri

lpfnUIDLLCallback

Puntatore a una funzione che la DLL dell'interfaccia utente può chiamare per comunicare con la DLL del provider di servizi per ottenere informazioni necessarie per visualizzare la finestra di dialogo e per inviare la configurazione aggiornata al provider di servizi.

hwndOwner

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

dwPermanentProviderID

Identificatore del provider di servizi permanente.

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 le chiamate di TSPI_providerInit e TSPI_providerShutdown.

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

Non esiste alcuna funzione direttamente corrispondente 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.