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

Vedi anche

PHONECAPS

TSPI_phoneGetID