WinRUI 函数为所有 Microsoft基于® Windows® 的请求单元接口(RUI)谓词提供异步消息通知。
Syntax
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,则返回错误。