routproc

Fungsi routproc adalah prosedur perutean sampel. Ini harus disediakan sebagai bagian dari aplikasi. Ini dipanggil oleh Modul Akses Dinamis (DMOD) dengan pesan yang mungkin atau mungkin tidak untuk aplikasi ini Prosedur perutean panggilan DMOD pada gilirannya sampai seseorang menerima pesan.

Sintaks

  
DWORD routproc(   
BUFHDR *msgptr,   
USHORT locl,   
USHORT retstat   
);  

Parameter

msgptr
Arahkan ke pesan yang diteruskan oleh DMOD ke prosedur perutean.

locl
Lokalitas tempat pesan diterima (jika retstat menunjukkan pesan dikembalikan), atau lokalitas tempat jalur hilang (jika retstat menunjukkan kesalahan jalur).

retstat
Alasan panggilan:

CEDINMSG (1)—pesan dikembalikan.

CEDINLLN (2)—kesalahan jalur (lihat Keterangan di bawah).

Tampilkan Nilai

TRUE
Prosedur perutean telah menerima pesan.

FALSE
Pesan bukan untuk prosedur perutean ini.

Keterangan

Prosedur perutean harus terlebih dahulu memanggil sbpurcvx, yang menangani pesan respons Terbuka apa pun, sebagai berikut:

sbpurcvx(&msgptr, locl, retstat)

Kode pengembalian TRUE dari sbpurcvx menunjukkan bahwa sbpurcvx telah menerima pesan; Respons kesalahan terbuka telah diterima untuk aplikasi ini, dan lokasi sumber daya sedang dilanjutkan. Prosedur perutean tidak boleh memproses pesan lebih lanjut dan harus mengembalikan TRUE untuk mencegah DMOD memanggil prosedur perutean lebih lanjut.

Kode pengembalian FALSE dari sbpurcvx menunjukkan bahwa prosedur perutean harus:

• Jika pesan untuk aplikasi ini, bertanggung jawab atas pesan dan kembaliKAN TRUE untuk mencegah DMOD memanggil prosedur perutean lebih lanjut.

• Jika pesan bukan untuk aplikasi ini, kembalikan FALSE sehingga DMOD mencoba prosedur perutean lebih lanjut.

  Jika kesalahan jalur dikembalikan, msgptr tidak akan menunjuk ke pesan yang valid, dan tidak ada lagi pesan antarmuka manajemen fungsi (FMI) yang akan dikembalikan untuk nilai lokalitas yang ditunjukkan. Aplikasi ini bertanggung jawab untuk mengakhiri semua sesi menggunakan lokalitas ini. Prosedur perutean harus mengembalikan FALSE. Ini memastikan bahwa lokalitas yang hilang dilaporkan ke semua prosedur perutean lainnya.

  Jika pesan untuk aplikasi ini, prosedur perutean dapat segera memproses pesan atau meletakkan pesan pada antrean aplikasi, lalu memposting aplikasi menggunakan semaphore. Untuk informasi selengkapnya, lihat Menerima Pesan.