Funzione phoneConfigDialog (tapi.h)
La funzione phoneConfigDialog fa sì che il provider del dispositivo telefonico specificato visualizzi una finestra di dialogo modale (collegata al parametro hwndOwner dell'applicazione) che consente all'utente di configurare i parametri correlati al dispositivo telefonico specificato da dwDeviceID.
Sintassi
LONG phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Parametri
dwDeviceID
Identificatore del dispositivo telefonico da configurare.
hwndOwner
Handle in una finestra a cui deve essere collegata la finestra di dialogo. Può essere un valore NULL per indicare che qualsiasi finestra creata durante la funzione non deve avere una finestra di proprietario.
lpszDeviceClass
Puntatore a una stringa con terminazione Null che identifica un nome di classe del dispositivo. Questa classe di dispositivo consente all'applicazione di selezionare una schermata secondaria specifica delle informazioni di configurazione applicabili a tale classe di dispositivo. Questo parametro è facoltativo e può essere lasciato NULL o vuoto, nel qual caso viene selezionata la configurazione di livello più alto.
Valore restituito
Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.
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 corrispondono a phoneGetID. Ad esempio, se il telefono supporta l'API wave, passando "wave/in" come lpszDeviceClass il provider visualizzerà i parametri correlati in modo specifico all'onda (o almeno per iniziare al punto corrispondente in una catena di finestre di dialogo di configurazione multilivello, eliminando la necessità di cercare parametri pertinenti).
Il parametro lpszDeviceClass 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 | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |
Vedi anche
Funzioni supplementari del servizio telefonico