fungsi phoneConfigDialog (tapi.h)

Fungsi phoneConfigDialog menyebabkan penyedia perangkat telepon yang ditentukan menampilkan kotak dialog modal (dilampirkan ke parameter hwndOwner aplikasi) yang memungkinkan pengguna untuk mengonfigurasi parameter yang terkait dengan perangkat telepon yang ditentukan oleh dwDeviceID.

Sintaks

LONG phoneConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parameter

dwDeviceID

Pengidentifikasi perangkat telepon yang akan dikonfigurasi.

hwndOwner

Tangani ke jendela tempat kotak dialog akan dilampirkan. Dapat berupa nilai NULL untuk menunjukkan bahwa jendela apa pun yang dibuat selama fungsi seharusnya tidak memiliki jendela pemilik.

lpszDeviceClass

Penunjuk ke string yang dihentikan null yang mengidentifikasi nama kelas perangkat. Kelas perangkat ini memungkinkan aplikasi untuk memilih sub-layar tertentu dari informasi konfigurasi yang berlaku untuk kelas perangkat tersebut. Parameter ini bersifat opsional dan dapat dibiarkan NULL atau kosong, dalam hal ini konfigurasi tingkat tertinggi dipilih.

Nilai kembali

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Keterangan

Parameter lpszDeviceClass memungkinkan aplikasi untuk memilih sub-layar tertentu dari informasi konfigurasi yang berlaku untuk kelas perangkat tempat pengguna tertarik; string yang diizinkan sama dengan untuk phoneGetID. Misalnya, jika telepon mendukung GELOMBANG API, melewati "wave/in" sebagai lpszDeviceClass akan menyebabkan penyedia menampilkan parameter yang terkait khusus untuk gelombang (atau setidaknya untuk memulai pada titik yang sesuai dalam rantai kotak dialog konfigurasi multitingkat, menghilangkan kebutuhan untuk mencari parameter yang relevan).

Parameter lpszDeviceClass harus "tapi/telepon", "", atau NULL menyebabkan penyedia menampilkan konfigurasi tingkat tertinggi untuk ponsel.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

Fungsi Layanan Telepon Tambahan

Gambaran Umum Referensi TAPI 2.2

phoneGetID