pesan LINE_PROXYREQUEST

Pesan TAPI LINE_PROXYREQUEST mengirimkan permintaan ke penangan fungsi proksi terdaftar.

Parameter

hDevice

Handel aplikasi ke perangkat baris tempat status agen berubah.

dwCallbackInstance

Instans panggilan balik disediakan saat membuka baris panggilan.

dwParam1

Penunjuk ke struktur LINEPROXYREQUEST yang berisi permintaan yang akan diproses oleh aplikasi handler proksi.

dwParam2

Dicadangkan.

dwParam3

Dicadangkan.

Menampilkan nilai

Tidak ada nilai yang ditampilkan.

Keterangan

Pesan LINE_PROXYREQUEST dikirim hanya ke aplikasi pertama yang terdaftar untuk menangani permintaan proksi jenis yang dikirimkan.

Aplikasi harus memproses permintaan yang terkandung dalam buffer proksi dan memanggil lineProxyResponse untuk mengembalikan data atau mengirimkan hasil. Pemrosesan permintaan harus dilakukan dalam konteks fungsi panggilan balik TAPI aplikasi hanya jika dapat dilakukan segera, tanpa menunggu respons dari entitas lain. Jika aplikasi perlu berkomunikasi dengan entitas lain (misalnya, penyedia layanan untuk menangani ACD berbasis PBX, atau layanan sistem lain yang mungkin mengakibatkan pemblokiran), maka permintaan harus diantrekan dalam aplikasi dan fungsi panggilan balik keluar untuk menghindari penundaan penerimaan pesan TAPI lebih lanjut oleh aplikasi.

Pada saat LINE_PROXYREQUEST dikirimkan ke handler proksi, TAPI telah mengembalikan hasil fungsi dwRequestID positif ke aplikasi asli dan membuka blokir utas panggilan untuk melanjutkan eksekusi. Aplikasi sedang menunggu pesan LINE_REPLY , yang secara otomatis dihasilkan ketika aplikasi handler proksi memanggil lineProxyResponse.

Aplikasi tidak akan membebaskan memori yang ditujukan oleh lpProxyRequest. TAPI membebaskan memori selama eksekusi lineProxyResponse. Aplikasi dapat memanggil lineProxyResponse tepat sekali untuk setiap pesan LINE_PROXYREQUEST .

Jika aplikasi menerima pesan LINE_CLOSE saat permintaan proksi tertunda, aplikasi harus memanggil lineProxyResponse untuk setiap permintaan yang tertunda, meneruskan nilai dwResult yang sesuai (seperti LINEERR_OPERATIONFAILED).

Persyaratan

Persyaratan	Nilai
Versi TAPI	Membutuhkan TAPI 2.0 atau yang lebih baru
Header	Tapi.h

Lihat juga

LINE_CLOSE

LINE_REPLY

LINEPROXYREQUEST

lineProxyResponse