funzione TSPI_lineConfigDialog (tspi.h)

Articolo
03/13/2024

La funzione TSPI_lineConfigDialog è obsoleta. I provider di servizi TAPI versione 1.4 o precedenti possono implementare questa funzione TSPI. Tapi versione 2.0 o successiva implementano TUISPI_lineConfigDialog.

La funzione TSPI_lineConfigDialog fa sì che il provider del dispositivo linea specificato visualizzi una finestra di dialogo modale come finestra figlio di hwndOwner per consentire all'utente di configurare i parametri correlati al dispositivo linea.

Sintassi

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parametri

dwDeviceID

Dispositivo linea da configurare.

hwndOwner

Handle per una finestra padre in cui deve essere inserita la finestra di dialogo.

lpszDeviceClass

Puntatore a una stringa Unicode con terminazione Null che identifica un nome di classe del dispositivo. Questa classe di dispositivo consente al chiamante di selezionare una schermata secondaria specifica delle informazioni di configurazione applicabili a tale classe del dispositivo. Se questo parametro è NULL o una stringa vuota, è necessario selezionare la finestra di dialogo di configurazione di livello più alto. Le stringhe consentite sono uguali a per TSPI_lineGetID. Ad esempio, se la riga supporta l'API Comm, il passaggio di comm/datamodem come lpszDeviceClass fa sì che il provider visualizzi i parametri correlati in modo specifico a Comm (o, almeno, per iniziare al punto corrispondente in una catena di finestre di dialogo di configurazione multilivello, in modo che l'utente non abbia la necessità di cercare i parametri desiderati).

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_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.

Commenti

La procedura deve aggiornare la sezione [Telefonia di Windows] nel file Win.ini e trasmettere il messaggio di WM_WININICHANGE se apporta modifiche al file Telephon.ini che provocherebbe una modifica delle funzionalità della riga o dell'indirizzo segnalate in LINEDEVCAPS o LINEADDRESSCAPS oppure se un dispositivo linea viene creato o rimosso.

Non esiste alcuna restrizione che questa funzione (TSPI_lineConfigDialog) venga chiamata solo quando la riga viene chiusa. Tuttavia, ogni provider può imporre tale restrizione. Quando viene chiamato TSPI_lineConfigDialog , il provider potrebbe avvisare l'utente con il messaggio "La riga è in uso da una o più applicazioni. Non è possibile modificare la configurazione della riga mentre la riga è in uso" (e restituire il messaggio di errore LINEERR_INUSE). Tuttavia, alcune configurazioni possono essere sicure per modificare "in tempo reale", in particolare quelle relative ai tipi di supporti (ad esempio il protocollo di controllo degli errori del modem), soprattutto quando tale tipo di supporto non è attualmente in uso. Il provider potrebbe consentire la modifica di tali opzioni mentre la riga è aperta.

Gli utenti non devono essere autorizzati a modificare qualsiasi elemento che modifica i valori restituiti con LINEDEVCAPS o LINEADDRESSCAPS senza prima chiudere forzatamente la riga come segnale che le applicazioni devono chiamare funzioni che restituiscono queste strutture per avere informazioni accurate.