WinRUI
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,则返回错误。