WinRUI 函式為所有基於 Microsoft® Windows® 的請求單元介面(RUI)動詞提供非同步訊息通知。
語法
int WINAPI WinRUI(
HWND hWnd,
LUA_VERB_RECORD FAR *lpVCB
);
參數
hWnd
接收訊息的視窗名稱。
LPVCB
指向邏輯單元應用(LUA)動詞控制區塊(VCB)的指標, LUA_VERB_RECORD。
傳回值
該函式回傳一個值,表示該請求是否被基於 Windows 的 RUI 接受進行處理。 回傳的值為零表示請求已被接受並將繼續處理。 值若非零,則表示錯誤。 可能的錯誤代碼如下:
WLUAINVALIDHANDLE
所提供的視窗句柄無效。
WLUASTARTUPNOTCALLED
應用程式尚未使用 WinRUIStartup 啟動會話。
lua_flag2.async 中回傳的值表示是否會發生非同步通知。 若標記設定為(非零),非同步通知將透過貼入應用程式訊息佇列的訊息發生。 若未設定旗標,請求將同步完成。 檢查主要退貨代碼和次要退貨代碼是否有錯誤狀況。
備註
當非同步操作完成後,應用程式視窗 hWnd 會接收由 RegisterWindowMessage 回傳的訊息,輸入字串為「WinRUI」。 lParam 參數包含 VCB 地址被標記為完整。 wParam 論證尚未定義。
備註
請求可能會被接受處理(函式呼叫回傳零),但之後在 VCB 中設置主回傳碼與次要回傳碼後被拒絕。 檢查主要退貨代碼和次要退貨代碼是否有錯誤狀況。
若應用程式在未先使用 WinRUIStartup 初始化會話前呼叫 WinRUI,則會回傳錯誤。