fungsi TSPI_lineDrop (tspi.h)

Artikel
03/03/2024

Fungsi TSPI_lineDrop menghilangkan atau memutuskan sambungan panggilan yang ditentukan. Informasi pengguna dapat secara opsional ditransmisikan sebagai bagian dari pemutusan panggilan. Fungsi ini dapat dipanggil oleh aplikasi kapan saja. Saat TSPI_lineDrop kembali, panggilan harus menganggur.

Sintaks

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Pegangan penyedia layanan ke panggilan yang akan dihentikan. Status panggilan hdCall dapat menjadi status apa pun kecuali diam.

lpsUserUserInfo

Penunjuk ini hanya valid jika dwSize bukan nol. Ini menentukan penunjuk ke string yang dihentikan null yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh sebagai bagian dari pemutusan panggilan. Penunjuk ini adalah NULL jika tidak ada informasi pengguna-pengguna yang akan dikirim. Informasi pengguna hanya dikirim jika didukung oleh jaringan yang mendasarinya (lihat LINEDEVCAPS).

dwSize

Ukuran dalam byte informasi pengguna-pengguna di lpsUserUserInfo. Jika lpsUserUserInfo adalah NULL, dwSize diabaikan.

Nilai kembali

Mengembalikan dwRequestID atau nomor kesalahan jika terjadi kesalahan. Parameter aktual lResult dari ASYNC_COMPLETION yang sesuai adalah nol jika fungsi berhasil atau nomor kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Keterangan

Penyedia layanan mengembalikan LINEERR_INVALCALLSTATE jika status panggilan saat ini tidak memungkinkan panggilan dihentikan.

Saat memanggil TSPI_lineDrop, panggilan terkait terkadang juga dapat terpengaruh. Misalnya, menghentikan panggilan konferensi dapat menghilangkan semua panggilan yang berpartisipasi individu. LINE_CALLSTATE pesan dikirim ke TAPI untuk semua panggilan yang status panggilannya terpengaruh. Biasanya, panggilan yang dihilangkan beralih ke status menganggur . Memanggil TSPI_lineDrop pada panggilan dalam status penawaran menolak panggilan. Tidak semua jaringan telepon menyediakan kemampuan ini.

Dalam situasi di mana panggilan yang akan dihentikan adalah panggilan konsultasi yang ditetapkan selama pembentukan panggilan transfer atau konferensi, panggilan asli yang ditempatkan dalam status OnHoldPending disambungkan kembali dan biasanya memasuki kembali status panggilan yang terhubung .

TAPI memiliki opsi untuk mengirim informasi pengguna pada saat pengantaran. Bahkan jika informasi pengguna dapat dikirim, tidak ada jaminan bahwa jaringan akan mengirimkan informasi ini ke pihak jarak jauh.

Catatan Dalam berbagai konfigurasi garis jembatan atau pihak ketika beberapa pihak sedang dalam panggilan, TSPI_lineDrop mungkin tidak benar-benar menghapus panggilan.