fungsi TSPI_lineAccept (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_lineAccept menerima panggilan yang ditawarkan yang ditentukan. Ini dapat secara opsional mengirim informasi pengguna-pengguna yang ditentukan ke pihak pemanggil.

Sintaks

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

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Handel ke panggilan yang akan diterima. Status panggilan hdCall dapat ditawarkan.

lpsUserUserInfo

Penunjuk ke string Unicode yang dihentikan null yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh sebagai bagian dari panggilan terima. Pointer ini 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 lpsUserUserInfoadalah NULL, dwSize diabaikan.

Nilai kembali

Mengembalikan dwRequestID jika fungsi selesai secara asinkron atau nomor kesalahan jika terjadi kesalahan. Parameter 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

Fungsi TSPI_lineAccept digunakan di lingkungan telepon (seperti ISDN) yang memungkinkan pemberitahuan yang terkait dengan panggilan masuk terpisah dari penawaran awal panggilan. Ketika panggilan masuk, panggilan pertama kali ditawarkan. Selama beberapa waktu kecil, aplikasi klien mungkin memiliki opsi untuk menolak panggilan menggunakan TSPI_lineDrop, mengalihkan panggilan ke stasiun lain menggunakan TSPI_lineRedirect, menjawab panggilan menggunakan TSPI_lineAnswer, atau menerima panggilan menggunakan TSPI_lineAccept. Setelah panggilan berhasil diterima, pemberitahuan di perangkat yang dipanggil dan memanggil dimulai, dan biasanya status panggilan beralih ke status yang diterima . Penyedia layanan harus mengatur bendera LINEADDRCAPFLAGS_ACCEPTTOALERT di anggota dwAddrCapFlags dari struktur data LINEADDRESSCAPS jika aplikasi harus memanggil TSPI_lineAccept agar pemberitahuan dimulai.

Untuk TAPI, pemberitahuan dilaporkan menggunakan pesan LINE_LINEDEVSTATE dengan indikasi dering .

TSPI_lineAccept juga dapat didukung oleh penyedia layanan non-ISDN. Transisi status panggilan ke status yang diterima dapat digunakan oleh klien TAPI lainnya sebagai indikasi bahwa beberapa aplikasi telah mengklaim bertanggung jawab atas panggilan dan telah memberikan panggilan kepada pengguna.

Aplikasi klien memiliki opsi untuk mengirim informasi pengguna-pengguna pada saat menerima. Bahkan jika informasi pengguna-pengguna dapat dikirim, seringkali tidak ada jaminan yang dibuat bahwa jaringan akan mengirimkan informasi ini kepada pihak pemanggil. Aplikasi klien dapat berkonsultasi dengan kemampuan perangkat baris untuk menentukan apakah penerimaan panggilan tersedia.