WinRUI

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

另请参阅


WinRUIStartup