fungsi lineAnswer (tapi.h)

Artikel
03/08/2023

Fungsi lineAnswer menjawab panggilan penawaran yang ditentukan.

Sintaks

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

Parameter

hCall

Tangani panggilan yang akan dijawab. Aplikasi harus menjadi pemilik panggilan ini. Status panggilan hCall harus menawarkan atau diterima.

lpsUserUserInfo

Penunjuk ke string yang dihentikan null yang berisi informasi pengguna-pengguna untuk dikirim ke pihak jarak jauh pada saat panggilan dijawab. 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). Bidang 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 lpsUserUserInfoADALAH NULL, tidak ada informasi pengguna yang dikirim ke pihak pemanggil dan dwSize diabaikan.

Menampilkan 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_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_NOTOWNER.

Keterangan

Ketika panggilan baru tiba, aplikasi dengan minat dalam panggilan dikirimi pesan LINE_CALLSTATE untuk memberikan handel panggilan baru dan untuk memberi tahu aplikasi tentang status panggilan dan hak istimewa untuk panggilan baru (seperti monitor atau pemilik). Aplikasi dengan hak istimewa pemilik untuk panggilan dapat menjawab panggilan ini menggunakan lineAnswer. Setelah panggilan berhasil dijawab, panggilan biasanya beralih ke status tersambung . Awalnya, hanya satu aplikasi yang diberikan hak istimewa pemilik untuk panggilan masuk.

Di beberapa lingkungan telepon (seperti ISDN), di mana pemberitahuan pengguna terpisah dari penawaran panggilan, aplikasi dapat memiliki opsi untuk menerima panggilan sebelum menjawab atau menolak atau mengalihkan panggilan penawaran.

Jika panggilan masuk (ditawarkan) pada saat panggilan lain sudah aktif, memanggil lineAnswer tersambung ke panggilan baru. Efek ini pada panggilan aktif yang ada tergantung pada kemampuan perangkat baris. Panggilan pertama dapat tidak terpengaruh, dapat secara otomatis dihilangkan, atau secara otomatis dapat ditangguhkan. Pesan LINE_CALLSTATE yang sesuai melaporkan transisi status ke aplikasi tentang kedua panggilan.

Dalam situasi terhubung, jika panggilan tersambung tetapi dalam status LINECONNECTEDMODE_INACTIVE, panggilan dapat digabungkan menggunakan fungsi lineAnswer .

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