TSPI_lineHold (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_lineHold menempatkan panggilan yang ditentukan ditangguhkan.

Sintaks

LONG TSPIAPI TSPI_lineHold(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Pegangan penyedia layanan ke panggilan untuk ditangguhkan. Status panggilan hdCall dapat dihubungkan.

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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Keterangan

Panggilan ditangguhkan untuk sementara waktu terputus, memungkinkan TAPI menggunakan perangkat baris untuk melakukan atau menjawab panggilan lain. TSPI_lineHold melakukan penahanan keras panggilan yang ditentukan, dibandingkan dengan panggilan konsultasi. Panggilan di hard hold biasanya tidak dapat ditransfer atau disertakan dalam panggilan konferensi, sedangkan panggilan konsultasi dapat dilakukan. Panggilan konsultasi dimulai menggunakan TSPI_lineSetupTransfer, TSPI_lineSetupConference, atau TSPI_linePrepareAddToConference.

Setelah panggilan berhasil ditangguhkan, status panggilan biasanya beralih ke onHold. Panggilan yang ditahan diambil melalui TSPI_lineUnhold. Saat panggilan ditangguhkan, penyedia layanan dapat mengirim pesan LINE_CALLSTATE tentang perubahan status panggilan yang ditahan. Misalnya, jika pihak yang ditahan berhenti, status panggilan dapat beralih ke terputus, dan penyedia layanan dapat mengirim pesan LINE_CALLSTATE yang menunjukkan status baru.