fungsi TUISPI_providerConfig (tspi.h)

Artikel
03/03/2024

Fungsi TUISPI_providerConfig mengimplementasikan elemen UI yang harus dijalankan dalam konteks aplikasi panggilan. Fungsi ini membuat fungsi TSPI_providerConfig usang di versi 2.0 dan yang lebih baru (didukung di versi 1.4 dan yang lebih lama).

Fungsi TUISPI_providerConfig mengumpulkan informasi konfigurasi dari pengguna. Ini dapat menggunakan kotak dialog, dan kotak dialog ini dapat menyertakan kotak sub-dialog yang terkait dengan API lain (seperti Comm/datamodem) untuk penyiapan perangkat tertentu.

Implementasi bersifat opsional.

Sintaks

LONG TSPIAPI TUISPI_providerConfig(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

Parameter

lpfnUIDLLCallback

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

hwndOwner

Handel jendela induk tempat fungsi dapat membuat jendela kotak dialog apa pun yang diperlukan selama konfigurasi.

dwPermanentProviderID

Pengidentifikasi penyedia permanen penyedia layanan.

Nilai kembali

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

LINEERR_OPERATIONFAILED, LINEERR_NOMEM.

Keterangan

Fungsi ini dapat dipanggil saat penyedia layanan sedang digunakan (yaitu, antara panggilan TSPI_providerInit dan TSPI_providerShutdown).

Setiap perubahan yang memengaruhi perilaku yang terlihat melalui TSPI harus berlaku hanya ketika penyedia layanan dimulai ulang pada TSPI_providerInit berikutnya.

Tidak ada fungsi yang sesuai langsung di tingkat TAPI. Di TAPI, aplikasi memiliki akses ke fungsi lineConfigDialog dan phoneConfigDialog, yang memungkinkan konfigurasi parameter saluran atau telepon tertentu setelah diinstal.