funzione TUISPI_phoneConfigDialog (tspi.h)
La funzione TUISPI_phoneConfigDialog fa sì che il provider del dispositivo telefonico specificato visualizzi una finestra di dialogo modale come finestra figlio di hwndOwner per consentire all'utente di configurare i parametri correlati al dispositivo telefonico. Questa funzione rende obsoleta la funzione TSPI_phoneConfigDialog nella versione 2.0 e successive (supportata nella versione 1.4 e precedenti).
L'implementazione è facoltativa.
Sintassi
LONG TSPIAPI TUISPI_phoneConfigDialog(
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 telefonico 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, viene selezionata la finestra di dialogo di configurazione di livello più alto.
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:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.
Commenti
Il parametro lpszDeviceClass consente all'applicazione di selezionare una schermata secondaria specifica delle informazioni di configurazione applicabili alla classe di dispositivo in cui l'utente è interessato. Le stringhe consentite sono uguali a per TSPI_phoneGetID.
Ad esempio, se il telefono 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 deve cercare i parametri desiderati). Il parametro szDeviceClass deve essere "tapi/phone", "" o NULL per fare in modo che il provider visualizzi la configurazione di livello più alto per il telefono.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |