fungsi lineClose (tapi.h)

Artikel
08/26/2023

Fungsi lineClose menutup perangkat open line yang ditentukan.

Sintaks

LONG lineClose(
  HLINE hLine
);

Parameter

hLine

Tangani ke perangkat baris terbuka yang akan ditutup. Setelah baris berhasil ditutup, handel ini tidak lagi valid.

Nilai kembali

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

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Keterangan

Jika aplikasi memanggil lineClose saat masih memiliki panggilan aktif di baris yang dibuka, kepemilikan aplikasi atas panggilan ini dicabut. Jika aplikasi adalah satu-satunya pemilik panggilan ini, panggilan juga dihilangkan. Ini adalah praktik pemrograman yang baik bagi aplikasi untuk membuang panggilan yang dimilikinya pada jalur yang dibuka dengan secara eksplisit melepaskan kepemilikan dan/atau dengan menjatuhkan panggilan ini sebelum menutup jalur.

Jika baris berhasil ditutup, pesan LINE_LINEDEVSTATE dikirim ke semua aplikasi yang memantau status baris perubahan terbuka/tutup. Balasan asinkron yang luar biasa ditekan.

Penyedia layanan mungkin merasa berguna atau perlu untuk secara paksa mengklaim kembali perangkat baris dari aplikasi yang membuka baris. Ini dapat berguna untuk mencegah aplikasi memonopoli perangkat baris terlalu lama. Jika ini terjadi, pesan LINE_CLOSE dikirim ke aplikasi, menentukan handel baris perangkat baris yang ditutup.

Fungsi lineOpen mengalokasikan sumber daya ke aplikasi pemanggilan, dan aplikasi dapat dicegah membuka baris jika sumber daya tidak tersedia. Oleh karena itu, aplikasi yang hanya sesekali menggunakan perangkat baris (seperti untuk melakukan panggilan keluar) harus menutup jalur ke sumber daya gratis dan memungkinkan aplikasi lain untuk membuka jalur.