TUISPI_phoneConfigDialog (tspi.h)

Fungsi TUISPI_phoneConfigDialog menyebabkan penyedia perangkat telepon yang ditentukan menampilkan kotak dialog modal sebagai jendela anak hwndOwner untuk memungkinkan pengguna mengonfigurasi parameter yang terkait dengan perangkat telepon. Fungsi ini membuat fungsi TSPI_phoneConfigDialog usang di versi 2.0 dan yang lebih baru (didukung di versi 1.4 dan yang lebih lama).

Implementasi bersifat opsional.

Sintaks

LONG TSPIAPI TUISPI_phoneConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

Parameter

lpfnUIDLLCallback

Penunjuk ke fungsi yang dapat dipanggil UI DLL untuk berkomunikasi dengan DLL penyedia layanan untuk mendapatkan informasi yang diperlukan untuk menampilkan kotak dialog dan untuk mengirim konfigurasi yang diperbarui ke penyedia layanan.

dwDeviceID

Perangkat telepon yang akan dikonfigurasi.

hwndOwner

Handel ke jendela induk tempat jendela kotak dialog akan ditempatkan.

lpszDeviceClass

Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi nama kelas perangkat. Kelas perangkat ini memungkinkan penelepon untuk memilih sub-layar tertentu dari informasi konfigurasi yang berlaku untuk kelas perangkat tersebut. Jika parameter ini adalah NULL atau string kosong, kotak dialog konfigurasi tingkat tertinggi dipilih.

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.

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 TSPI_phoneGetID.

Misalnya, jika ponsel mendukung Comm API, meneruskan comm/datamodem sebagai lpszDeviceClass menyebabkan penyedia menampilkan parameter yang terkait khusus dengan Comm (atau, setidaknya, untuk memulai dari titik yang sesuai dalam rantai kotak dialog konfigurasi multitingkat, sehingga pengguna tidak perlu mencari untuk menemukan parameter yang diinginkan). Parameter szDeviceClass harus "tapi/phone", "", atau NULL menyebabkan penyedia menampilkan konfigurasi tingkat tertinggi untuk ponsel.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

PHONECAPS

TSPI_phoneGetID