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

另请参阅

RUI
WinRUIStartup