funzione TUISPI_lineConfigDialog (tspi.h)

Articolo
08/26/2023

La funzione TUISPI_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. Questa funzione rende obsoleta la funzione TSPI_lineConfigDialog nella versione 2.0 e successiva (supportata nella versione 1.4 e versioni precedenti).

L'implementazione è facoltativa.

Sintassi

LONG TSPIAPI TUISPI_lineConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

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.

dwDeviceID

Dispositivo linea da configurare.

hwndOwner

Handle a una finestra padre in cui deve essere posizionata la finestra della finestra di dialogo.

lpszDeviceClass

Puntatore a una stringa con terminazione null che identifica un nome della classe di dispositivo. Questa classe di dispositivo consente al chiamante di selezionare una sottoscreen specifica delle informazioni di configurazione applicabili a tale classe di dispositivo. Se questo parametro è NULL o una stringa vuota, è necessario selezionare la finestra di dialogo configurazione di livello più alto. Le stringhe consentite sono uguali a per TSPI_lineGetID. Ad esempio, se la riga supporta l'API Comm, passando 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

Non esiste alcuna restrizione che TUISPI_lineConfigDialog essere chiamata solo quando la riga viene chiusa. Tuttavia, ogni provider può imporre tale restrizione. Quando viene chiamato TUISPI_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 di modificare "a comparsa", in particolare quelle correlate 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 LINEEVCAPS o LINEADDRESSCAPS senza prima chiudere la riga come segnale che le applicazioni devono chiamare funzioni che restituiscono queste strutture per avere informazioni accurate.