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

Panoramica dei riferimenti a TAPI 2.2

phoneGetID