fungsi TSPI_providerInstall (tspi.h)

Artikel
03/13/2024

Fungsi TSPI_providerInstall usang. TAPI versi 1.4 atau penyedia layanan yang lebih lama dapat menerapkan fungsi TSPI ini. TSP TAPI versi 2.0 atau yang lebih baru menerapkan TUISPI_providerInstall.

Fungsi TSPI_providerInstall menginstal "bagian" tambahan penyedia ke direktori yang tepat (atau setidaknya memverifikasi bahwa mereka ada di sana), mengatur entri registri penyedia untuk saluran dan teleponnya, dan membuat entri lain yang diperlukan untuk penyedia layanan. Ini dipanggil dari utilitas telefoni Panel Kontrol (disediakan dengan Windows Telephony dalam versi 1.4 dan yang lebih lama) ketika tombol Tambahkan ditekan.

Sintaks

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Parameter

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 menyelesaikan penginstalan bagian lain yang diperlukan oleh penyedia layanan setelah entrinya di bagian [Penyedia] di registri telah dibuat. Jika penyedia layanan memerlukan entri tambahan yang ditentukan secara privat dalam registri untuk operasi yang tepat, mereka juga harus diinstal. Cara umum untuk menginstal bagian ini dengan entrinya adalah dengan memanggil TSPI_providerConfig.

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 hanya dipanggil sekali, selama penginstalan penyedia layanan, sampai ada panggilan ke TSPI_providerRemove. Ini harus dipanggil sebelum fungsi lain yang ditentukan TSPI.

Utilitas telefoni Panel Kontrol disediakan dengan Windows Telephony dalam versi 1.4 dan yang lebih lama memanggil fungsi ini (dengan persyaratan urutan eksternal terpenuhi seperti yang dijelaskan di sini) ketika perintah "tambahkan" dipanggil. Ini tidak memanggil TSPI_providerConfig untuk perintah "tambahkan".

Tidak ada fungsi yang sesuai di tingkat TAPI. Pada tingkat tersebut, aplikasi berharap memiliki penyedia layanan yang sudah diinstal. Aplikasi yang berjalan diberi tahu tentang konfigurasi ulang dinamis melalui nilai LINEDEVSTATE_REINIT atau PHONESTATE_REINIT dalam pesan LINE_LINEDEVSTATE atau PHONE_STATE.