WinRUI

Fungsi WinRUI menyediakan pemberitahuan pesan asinkron untuk semua kata kerja Request Unit Interface (RUI) berbasis Microsoft® Windows®.

Sintaks

  
int WINAPI WinRUI(   
HWND hWnd,    
LUA_VERB_RECORD FAR *lpVCB  
);  

Parameter

hWnd
Tangani jendela untuk menerima pesan.

lpVCB
Penunjuk ke blok kontrol kata kerja (VCB) aplikasi unit logis (LUA), LUA_VERB_RECORD.

Tampilkan Nilai

Fungsi mengembalikan nilai yang menunjukkan apakah permintaan diterima oleh RUI berbasis Windows untuk diproses. Nilai nol yang dikembalikan menunjukkan bahwa permintaan diterima dan akan diproses. Nilai selain nol menunjukkan kesalahan. Kemungkinan kode kesalahan adalah sebagai berikut:

WLUAINVALIDHANDLE
Handel jendela yang disediakan tidak valid.

WLUASTARTUPNOTCALLED
Aplikasi belum memulai sesi menggunakan WinRUIStartup.

Nilai yang dikembalikan di lua_flag2.asinkron menunjukkan apakah pemberitahuan asinkron akan terjadi. Jika bendera diatur (bukan nol), pemberitahuan asinkron akan terjadi melalui pesan yang diposting ke antrean pesan aplikasi. Jika bendera tidak diatur, permintaan selesai secara sinkron. Periksa kode pengembalian utama dan kode pengembalian sekunder untuk kondisi kesalahan apa pun.

Keterangan

Ketika operasi asinkron selesai, jendela aplikasi hWnd menerima pesan yang dikembalikan oleh RegisterWindowMessage dengan "WinRUI" sebagai string input. Argumen lParam berisi alamat VCB yang sedang diposting sebagai lengkap. Argumen wParam tidak ditentukan.

Catatan

Dimungkinkan bagi permintaan untuk diterima untuk diproses (panggilan fungsi mengembalikan nol) tetapi ditolak kemudian dengan kode pengembalian utama dan kode pengembalian sekunder yang diatur dalam VCB. Periksa kode pengembalian utama dan kode pengembalian sekunder untuk kondisi kesalahan apa pun.

Jika aplikasi memanggil WinRUI tanpa terlebih dahulu menginisialisasi sesi menggunakan WinRUIStartup, kesalahan akan dikembalikan.

Lihat juga

RUI
WinRUIStartup