fungsi lineHold (tapi.h)

Artikel
08/26/2023

Fungsi lineHold menempatkan panggilan yang ditentukan ditangguhkan.

Sintaks

LONG lineHold(
  HCALL hCall
);

Parameter

hCall

Tangani ke panggilan yang akan ditangguhkan. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall harus tersambung.

Nilai kembali

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan LINE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

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

Keterangan

Panggilan ditangguhkan untuk sementara waktu terputus memungkinkan aplikasi menggunakan perangkat baris untuk melakukan atau menjawab panggilan lain. Fungsi lineHold melakukan apa yang disebut "hard hold" dari panggilan yang ditentukan (dibandingkan dengan "panggilan konsultasi"). Panggilan dengan tangguh biasanya tidak dapat ditransfer atau disertakan dalam panggilan konferensi, tetapi panggilan konsultasi dapat dilakukan. Panggilan konsultasi dimulai menggunakan lineSetupTransfer, lineSetupConference, atau linePrepareAddToConference.

Setelah panggilan berhasil ditangguhkan, status panggilan biasanya beralih ke onHold. Panggilan yang ditahan diambil oleh lineUnhold. Saat panggilan ditangguhkan, aplikasi dapat menerima pesan LINE_CALLSTATE tentang perubahan status panggilan yang ditahan. Misalnya, jika pihak yang ditahan berhenti, status panggilan dapat beralih ke terputus.

Dalam situasi jembatan, operasi lineHold mungkin mungkin tidak benar-benar menangguhkan panggilan, karena status stasiun lain pada panggilan dapat mengatur (misalnya, mencoba "menahan" panggilan ketika stasiun lain berpartisipasi tidak dimungkinkan); sebaliknya, panggilan hanya dapat diubah ke mode LINECONNECTEDMODE_INACTIVE jika tetap terhubung di stasiun lain.