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

Panoramica di riferimento su TAPI 2.2

lineGetID