fungsi lineAccept (tapi.h)

Artikel
08/26/2023

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

Sintaks

LONG lineAccept(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parameter

hCall

Tangani panggilan untuk diterima. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall harus ditawarkan.

lpsUserUserInfo

Penunjuk ke string yang dihentikan null yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh sebagai bagian dari penerimaan panggilan. Penunjuk ini dapat dibiarkan NULL jika tidak ada informasi pengguna-pengguna yang akan dikirim. Informasi pengguna hanya dikirim jika didukung oleh jaringan yang mendasarinya (lihat LINEDEVCAPS). Anggota diskriminator protokol untuk informasi pengguna-pengguna, jika diperlukan, akan muncul sebagai byte pertama dari buffer yang ditunjukkan oleh lpsUserUserInfo, dan harus diperbantukan dalam dwSize.

dwSize

Ukuran informasi pengguna di lpsUserUserInfo (termasuk terminator null ), dalam byte. Jika lpsUserUserInfo adalah NULL, tidak ada informasi pengguna yang dikirim ke pihak pemanggil dan dwSize diabaikan.

Mengembalikan nilai

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_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED, LINEERR_USERUSERINFOTOOBIG.

Keterangan

Fungsi lineAccept digunakan di lingkungan telepon seperti Integrated Services Digital Network (ISDN) yang memungkinkan pemberitahuan yang terkait dengan panggilan masuk terpisah dari penawaran awal panggilan. Ketika panggilan masuk, panggilan pertama kali ditawarkan. Untuk beberapa waktu kecil, aplikasi mungkin memiliki opsi untuk menolak panggilan menggunakan lineDrop, mengalihkan panggilan ke stasiun lain menggunakan lineRedirect, menjawab panggilan menggunakan lineAnswer, atau menerima panggilan menggunakan lineAccept. Setelah panggilan berhasil diterima oleh aplikasi, pemberitahuan dimulai pada perangkat yang dipanggil dan memanggil dan status panggilan biasanya beralih ke diterima.

Pemberitahuan dilaporkan ke aplikasi oleh pesan LINE_LINEDEVSTATE dengan indikasi dering .

Fungsi lineAccept juga dapat didukung oleh penyedia layanan non-ISDN. Transisi status panggilan ke diterima dapat digunakan oleh aplikasi lain sebagai indikasi bahwa aplikasi lain telah mengklaim bertanggung jawab atas panggilan dan telah menyajikan panggilan kepada pengguna.

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