funzione TSPI_phoneConfigDialog (tspi.h)

La funzione TSPI_phoneConfigDialog è obsoleta. I provider di servizi TAPI versione 1.4 o precedenti possono implementare questa funzione TSPI. TapI versione 2.0 o successiva implementano TUISPI_phoneConfigDialog.

La funzione TSPI_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.

Sintassi

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

Parametri

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

TSPI_phoneConfigDialog fa sì che il provider di servizi visualizzi una finestra di dialogo modale come finestra figlio di hWndOwner per consentire all'utente di configurare i parametri correlati al telefono specificato da dwDeviceID. 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.

La procedura deve aggiornare la sezione [Telefonia di Windows] nel file di Win.ini e trasmettere il messaggio di WM_WININICHANGE se apporta modifiche a Telephon.ini che influiscono sul contenuto delle strutture visibili alle applicazioni (ad esempio PHONECAPS) o se i dispositivi telefonici vengono creati o rimossi.

Requisiti

Vedi anche

PHONECAPS

TSPI_phoneGetID