funzione lineConfigDialog (tapi.h)
La funzione lineConfigDialog consente al provider del dispositivo della riga specificata di visualizzare una finestra di dialogo (collegata a hwndOwner dell'applicazione) per consentire all'utente di configurare i parametri correlati al dispositivo linea.
Sintassi
LONG lineConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Parametri
dwDeviceID
Identificatore del dispositivo della riga da configurare.
hwndOwner
Gestire una finestra a cui collegare la finestra di dialogo. Può essere NULL per indicare che qualsiasi finestra creata durante la funzione non deve avere alcuna finestra proprietario.
lpszDeviceClass
Puntatore a una stringa con terminazione null che identifica un nome della classe di dispositivo. Questa classe di dispositivo consente all'applicazione di selezionare una sottoscreen specifica delle informazioni di configurazione applicabili a tale classe di dispositivo. Questo parametro è facoltativo e può essere lasciato NULL o vuoto, nel qual caso è selezionata la configurazione di livello più alto.
Valore restituito
Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:
LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.
Commenti
La funzione lineConfigDialog consente al provider di servizi di visualizzare una finestra di dialogo modale (collegata a hwndOwner dell'applicazione) per consentire all'utente di configurare i parametri correlati alla riga specificata da dwDeviceID. Il parametro lpszDeviceClass consente all'applicazione di selezionare una sottoscreen specifica delle informazioni di configurazione applicabili alla classe di dispositivo in cui l'utente è interessato; le stringhe consentite sono uguali a per lineGetID. Ad esempio, se la riga supporta l'API Comm, passando "COMM" come lpszDeviceClass fa sì che il provider visualizzi i parametri correlati in modo specifico a Comm (o, almeno, inizia al punto corrispondente in una catena di finestre di dialogo di configurazione multilevel, quindi l'utente non deve "scavare" per trovare i parametri di interesse).
Il parametro lpszDeviceClass sarebbe "tapi/line" , "" o NULL per consentire al provider di visualizzare la configurazione di livello più alto per la riga.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |
Vedi anche
Informazioni di riferimento sui servizi di telefonia di base