fungsi lineRemoveProvider (tapi.h)

Artikel
03/09/2024

Fungsi lineRemoveProvider menghapus penyedia layanan telepon yang ada dari sistem telepon.

Sintaks

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

Parameter

dwPermanentProviderID

Pengidentifikasi penyedia permanen penyedia layanan yang akan dihapus.

hwndOwner

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

Nilai kembali

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

LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM, LINEERR_OPERATIONFAILED.

Keterangan

Jika panggilan ke TSPI_providerRemove berhasil, dan sistem telepon aktif pada saat itu, TAPI memanggil lineShutdown dan/atau phoneShutdown pada penyedia layanan (tergantung pada jenis perangkat mana yang aktif). Setiap handel saluran atau telepon yang masih dipegang oleh aplikasi pada perangkat terkait ditutup secara paksa dengan pesan LINE_CLOSE atau PHONE_CLOSE (lebih disukai penyedia layanan untuk mengeluarkan pesan ini sebagai bagian dari TSPI_providerRemove, setelah verifikasi dengan pengguna). Perangkat yang sebelumnya berada di bawah kendali penyedia tersebut kemudian ditandai sebagai "tidak tersedia", sehingga upaya apa pun di masa mendatang oleh aplikasi untuk mereferensikannya oleh pengidentifikasi perangkat menghasilkan LINEERR_NODRIVER.