TUISPI_providerInstall (tspi.h)

Artikel
08/26/2023

Implementasi fungsi TUISPI_providerInstall adalah kesempatan penyedia layanan untuk menginstal "potongan" tambahan penyedia ke direktori yang tepat (atau setidaknya memverifikasi bahwa mereka ada di sana) dan menyiapkan entri registri yang dibutuhkan penyedia. Fungsi ini membuat fungsi TSPI_providerInstall usang di versi 2.0 dan yang lebih baru (didukung di versi 1.4 dan yang lebih lama).

Jika penyedia layanan memerlukan entri yang ditentukan secara privat dalam registri untuk operasi yang tepat, mereka harus diinstal saat ini.

Implementasi bersifat opsional.

Sintaks

LONG TSPIAPI TUISPI_providerInstall(
  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.

hwndOwner

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

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_INIFILECORRUPT, LINEERR_NOMEM. LINEERR_INVALPARAM.

Keterangan

Fungsi ini harus membiarkan sistem dalam keadaan konsisten. Ini harus berjalan hingga selesai, tidak memungkinkan pengguna untuk membatalkan penginstalan ketika sebagian selesai. Jika penginstalan gagal, penyedia bertanggung jawab untuk "mundur" apa yang dilakukan dan mengembalikan kesalahan. Ini mungkin menyiratkan pra-pemindaian untuk memverifikasi bahwa penginstalan lengkap dimungkinkan, sebelum penginstalan dimulai.

Fungsi ini dapat dipanggil lebih dari sekali selama penginstalan penyedia layanan, sampai ada panggilan ke TUISPI_providerRemove. Namun, jika penyedia layanan tidak memerlukan atau mendukung beberapa instans penyedia, penyedia akan mengembalikan LINEERR_NOMULTIPLEINSTANCE konstanta LINEERR_ .

Fungsi yang sesuai di tingkat TAPI adalah lineAddProvider. Pesan LINE_CREATE menginformasikan aplikasi yang berjalan tentang konfigurasi ulang dinamis.