Funzione phoneConfigDialog (tapi.h)

Articolo
08/26/2023

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.