lineRegisterRequestRecipient function (tapi.h)

Artikel
03/08/2023

Fungsi lineRegisterRequestRecipient mendaftarkan aplikasi pemanggilan sebagai penerima permintaan untuk mode permintaan yang ditentukan.

Sintaks

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

Parameter

hLineApp

Handel penggunaan aplikasi untuk bagian baris TAPI.

dwRegistrationInstance

DWORD khusus aplikasi yang diteruskan kembali sebagai parameter pesan LINE_REQUEST. Pesan ini memberi tahu aplikasi bahwa permintaan tertunda. Parameter ini diabaikan jika bEnable diatur ke nol. Parameter ini diperiksa oleh TAPI hanya untuk pendaftaran, bukan untuk deregistrasi. Nilai dwRegistrationInstance yang digunakan saat membatalkan pendaftaran tidak perlu cocok dengan dwRegistrationInstance yang digunakan saat mendaftar untuk mode permintaan.

dwRequestMode

Jenis permintaan yang didaftarkan aplikasi. Parameter ini menggunakan satu atau beberapa konstanta LINEREQUESTMODE_.

bEnable

Jika TRUE, aplikasi mendaftarkan mode permintaan yang ditentukan; jika FALSE, aplikasi membatalkan pendaftaran untuk mode permintaan yang ditentukan.

Nilai kembali

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Keterangan

Aplikasi yang mendukung telepon dapat meminta agar panggilan dilakukan atas namanya dengan memanggil tapiRequestMakeCall. Selain itu, aplikasi lain dapat meminta agar informasi dicatat dengan panggilan tertentu. Permintaan tapiRequestMakeCall diantrekan oleh TAPI, dan aplikasi prioritas tertinggi yang telah terdaftar untuk menangani permintaan dikirimi pesan LINE_REQUEST dengan indikasi mode permintaan yang tertunda. Aplikasi ini biasanya merupakan aplikasi kontrol panggilan pengguna.

Selanjutnya, aplikasi kontrol panggilan yang menerima pesan ini memanggil lineGetRequest, menentukan mode permintaan dan buffer yang cukup besar untuk menahan permintaan. Aplikasi kontrol panggilan kemudian menginterpretasikan dan menjalankan permintaan.

Aplikasi penerima juga secara otomatis dibatalkan pendaftarannya untuk semua permintaan ketika melakukan lineShutdown.