fungsi lineDeallocateCall (tapi.h)

Artikel
08/26/2023

Fungsi lineDeallocateCall membatalkan alokasi handel panggilan yang ditentukan.

Sintaks

LONG lineDeallocateCall(
  HCALL hCall
);

Parameter

hCall

Handel panggilan yang akan dibatalkan alokasinya. Aplikasi dengan hak istimewa pemantauan untuk panggilan selalu dapat membatalkan alokasi handelnya untuk panggilan tersebut. Aplikasi dengan hak istimewa pemilik untuk panggilan dapat membatalkan handelnya kecuali jika itu adalah pemilik satu-satunya panggilan dan panggilan tidak dalam status menganggur . Handel panggilan tidak lagi valid setelah dibatalkan alokasinya.

Menampilkan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan meliputi:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Keterangan

Pembatalan alokasi tidak memengaruhi status panggilan panggilan fisik. Namun, merilis sumber daya internal yang terkait dengan panggilan.

Dalam versi API, yang lebih lama dari 2.0, jika aplikasi adalah pemilik satu-satunya panggilan dan panggilan tidak dalam status menganggur, LINEERR_INVALCALLSTATE dikembalikan. Dalam hal ini, aplikasi dapat terlebih dahulu menghilangkan panggilan menggunakan lineDrop dan membatalkan alokasi handel panggilannya setelahnya. Aplikasi yang memiliki hak istimewa pemantauan untuk panggilan selalu dapat membatalkan alokasi handelnya untuk panggilan.

Dalam API versi 2.0 atau yang lebih baru, pemilik satu-satunya panggilan dapat membatalkan alokasi handelnya meskipun panggilan tidak dalam status diam . Ini memungkinkan kontrol panggilan terdistribusi di lingkungan klien/server.

Catatan Meninggalkan panggilan tanpa pemilik dapat mengakibatkan pengguna tidak dapat menghentikan panggilan jika ada aplikasi pemantauan terbuka yang mencegah TAPI memanggil TSPI_lineCloseCall. Gunakan fitur ini hanya jika aplikasi dapat menentukan bahwa panggilan dapat dikontrol secara eksternal oleh pengguna. Untuk informasi selengkapnya, lihat LINEADDRCAPFLAGS_CLOSEDROP.

Dalam versi API yang lebih lama dari 2.0, ketika fungsi lineDeallocateCall membatalkan handel panggilan, fungsi ini juga menangguhkan pemrosesan lebih lanjut dari pesan LINE_REPLY yang berutang untuk panggilan. Aplikasi harus dirancang untuk tidak menunggu tanpa batas waktu untuk pesan LINE_REPLY untuk setiap panggilan yang sesuai ke fungsi asinkron jika juga menggunakan fungsi lineDeallocateCall untuk membatalkan handel.

Dalam API versi 2.0 atau yang lebih baru, lineDeallocateCall tidak menangguhkan pesan LINE_REPLY yang berutang; setiap fungsi asinkron yang mengembalikan dwRequestID ke aplikasi selalu menghasilkan pengiriman pesan LINE_REPLY terkait kecuali aplikasi memanggil lineShutdown.