WinRUI
La función WinRUI proporciona una notificación de mensaje asincrónica para todos los verbos de interfaz de unidad de solicitud (RUI) basados en Microsoft® Windows®.
Sintaxis
int WINAPI WinRUI(
HWND hWnd,
LUA_VERB_RECORD FAR *lpVCB
);
Parámetros
hWnd
Identificador de la ventana para recibir el mensaje.
lpVCB
Puntero al bloque de control de verbo (VCB) de la aplicación de unidad lógica (LUA), LUA_VERB_RECORD.
Valor devuelto
La función devuelve un valor que indica si el RUI basado en Windows aceptó la solicitud para su procesamiento. Un valor devuelto de cero indica que se aceptó la solicitud y se procesará. Un valor distinto de cero indica un error. Los códigos de error posibles son los siguientes:
WLUAINVALIDHANDLE
El identificador de ventana proporcionado no es válido.
WLUASTARTUPNOTCALLED
La aplicación no ha iniciado una sesión con WinRUIStartup.
El valor devuelto en lua_flag2.async indica si se producirá una notificación asincrónica. Si se establece la marca (distinto de cero), se producirá una notificación asincrónica a través de un mensaje publicado en la cola de mensajes de las aplicaciones. Si no se establece la marca, la solicitud se completó sincrónicamente. Examine el código de retorno principal y el código de retorno secundario para ver si hay condiciones de error.
Comentarios
Una vez completada la operación asincrónica, la ventana de aplicaciones hWnd recibe el mensaje devuelto por RegisterWindowMessage con "WinRUI" como la cadena de entrada. El argumento lParam contiene la dirección del VCB que se está publicando como completa. El argumento wParam no está definido.
Nota
Es posible que la solicitud se acepte para su procesamiento (la llamada de función devuelve cero), pero se rechaza más adelante con un código de retorno principal y un código de retorno secundario establecido en el VCB. Examine el código de retorno principal y el código de retorno secundario para ver si hay condiciones de error.
Si la aplicación llama a WinRUI sin inicializar primero la sesión mediante WinRUIStartup, se devuelve un error.