fungsi lineAddProvider (tapi.h)

Artikel
03/02/2024

Fungsi lineAddProvider menginstal penyedia layanan telepon baru ke dalam sistem telepon.

Sintaks

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

Parameter

lpszProviderFilename

Penunjuk ke

string yang dihentikan null yang berisi jalur penyedia layanan yang akan ditambahkan.

hwndOwner

Tangani ke jendela tempat kotak dialog apa pun yang perlu ditampilkan sebagai bagian dari proses penginstalan (misalnya, oleh fungsi TSPI_providerInstall penyedia layanan) akan dilampirkan. Dapat berupa NULL untuk menunjukkan bahwa setiap jendela yang dibuat selama fungsi seharusnya tidak memiliki jendela pemilik.

lpdwPermanentProviderID

Penunjuk ke variabel yang menerima pengidentifikasi penyedia permanen penyedia layanan yang baru diinstal.

Nilai kembali

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

LINEERR_INIFILECORRUPT, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE, LINEERR_OPERATIONFAILED.

Keterangan

Selama panggilan fungsi ini, TAPI memeriksa untuk memastikan bahwa ia dapat mengakses penyedia layanan dengan memanggil fungsi TSPI_providerInstall ; jika ini tidak berhasil (jika DLL atau fungsi tidak dapat ditemukan, atau jika TSPI_providerInstall mengembalikan kesalahan), fungsi gagal dan penyedia tidak ditambahkan ke sistem telepon. Jika ini berhasil, dan sistem Telepon aktif (satu atau beberapa aplikasi telah disebut lineInitialize atau lineInitializeEx), TAPI tidak mencoba meluncurkan penyedia layanan yang baru ditambahkan. Sebagai gantinya, untuk mengaktifkan penyedia layanan baru, TAPI mengeluarkan pesan untuk memulai ulang Windows. Ketika aktivasi berhasil, aplikasi diberitahu tentang perangkat baru apa pun yang dibuat dengan cara LINE_CREATE atau pesan PHONE_CREATE , atau oleh pesan LINE_LINEDEVSTATE yang meminta reinisialisasi (jika aplikasi tidak mendukung pesan CREATE).

Fungsi ini tidak menyalin file—bukan DLL penyedia layanan itu sendiri atau file pendukung; aplikasi yang mengelola penambahan penyedia harus memastikan bahwa penyedia diinstal dalam direktori di mana dapat ditemukan oleh TAPI (misalnya, \WINDOWS, \WINDOWS\SYSTEM, atau di tempat lain di jalur).