WinRUIStartup

La función WinRUIStartup permite Windows una aplicación que usa verbos de interfaz de unidad de solicitud (VERB) especificar la versión de una aplicación de unidad lógica (LUA) necesaria y recuperar los detalles de la implementación específica de LUA de Microsoft Windows. Una aplicación debe llamar a esta función para registrarse con una implementación de LUA Windows antes de emitir más Windows llamadas LUA.

Sintaxis

  
          int WINAPI WinRUIStartup(   
WORD wVersionRequired,    
  LUADATA FAR *lpLuaData  );  

Parámetros

wVersionRequired
Especifica la versión de Windows compatibilidad con LUA necesaria. El byte de orden superior especifica el número de versión secundaria (revisión). El byte de orden bajo especifica el número de versión principal.

lpLuaData
Puntero a la estructura LUADATA que contiene la información del número de versión devuelto.

Valor devuelto

El código de retorno especifica si la aplicación se registró correctamente y si la implementación Windows LUA puede admitir el número de versión especificado. Si el valor es cero, se registró correctamente y se puede admite la versión especificada. De lo contrario, el código de retorno es uno de los siguientes:

WLUASYSNOTREADY
El sistema de red subyacente no está listo para la comunicación de red.

WLUAVERNOTSUPPORTED
Esta implementación Windows Windows LUA no proporciona la versión de la compatibilidad con LUA solicitada.

WLUAINVALID
La Windows lua especificada por la aplicación no es compatible con esta biblioteca de vínculos dinámicos (DLL).

WLUAFAILURE
Se produjo un error mientras se inicializaba Windows DLL de LUA. Esto suele ocurrir porque se produce un error en una llamada de sistema operativo.

WLUAINITREJECT
Se llamó a WinRUIStartup varias veces.

Observaciones

Para admitir futuras Windows de LUA y aplicaciones que pueden tener diferencias de funcionalidad, tiene lugar una negociación en WinRUIStartup. Una aplicación pasa a WinRUIStartup la Windows LUA que puede usar. Si esta versión es inferior a la versión más baja admitida por Windows DLL de LUA, el archivo DLL no puede admitir la aplicación y WinRUIStartup produce un error. Sin embargo, si la versión no es inferior, la llamada se realiza correctamente y devuelve la versión más alta de Windows LUA compatible con el archivo DLL. Si esta versión es inferior a la versión más baja admitida por la aplicación, la aplicación produce un error en su inicialización o intenta encontrar otro archivo DLL Windows LUA en el sistema.

Esta negociación permite que tanto un archivo DLL Windows LUA como una Windows LUA admitan una variedad de versiones Windows LUA. Una aplicación puede usar correctamente un archivo DLL si hay alguna superposición en las versiones. En la tabla siguiente se muestra cómo funciona WinRUIStartup junto con diferentes versiones de dll y aplicaciones.

Versiones de la aplicación LUA Versiones de DLL de LUA En

WinRUIStartup
De

WinRUIStartup
Resultado
1.0 1.0 1.0 1.0 Uso de la versión 1.0
1.0, 2.0 1.0 2.0 1.0 Uso de la versión 1.0
1,0 1.0, 2.0 1.0 2.0 Uso de la versión 1.0
1,0 2.0, 3.0 1,0 WLUAINVALID Suspenso
2.0, 3.0 1,0 3.0 1.0 Se produce un error en la aplicación
1.0, 2.0, 3.0 1.0, 2.0, 3.0 3.0 3.0 Uso de la versión 3.0

Nota

La aplicación que usa verbos de VERB debe llamar a WinRUIStartup antes de emitir cualquier otro comando LUA. Sin embargo, solo se debe llamar a WinRUIStartup una vez por aplicación. Si se llama varias veces, se rechazarán las llamadas posteriores.

Los detalles de la implementación real de LUA se describen en la estructura WLUADATA , definida de la siguiente manera:

typedef struct { WORD wVersion;  
            char szDescription[WLUADESCRIPTION_LEN+1];  
            } LUADATA;  

Una vez realizada su última Windows LUA, una aplicación debe llamar a la rutina WinRUICleanup.

Cada aplicación DE LUA que usa verbos VERB debe realizar una llamada WinRUIStartup antes de emitir cualquier otra llamada LUA.

Consulte también

WinRUICleanup