WinRUIStartup

la fonction WinRUIStartup permet à une application utilisant des verbes RUI (Request unit Interface) de spécifier la version de Windows application d’unité logique (lua) requise et de récupérer les détails de l’implémentation spécifique du lua Microsoft Windows. cette fonction doit être appelée par une application pour s’inscrire auprès d’une implémentation Windows lua avant d’émettre d’autres appels lua Windows.

Syntaxe

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

Paramètres

wVersionRequired
spécifie la version de Windows prise en charge LUA requise. L’octet de poids fort spécifie le numéro de version mineure (révision). L’octet de poids faible spécifie le numéro de version principale.

lpLuaData
Pointeur vers la structure LUADATA contenant les informations de numéro de version retournées.

Valeur renvoyée

le code de retour spécifie si l’application a été inscrite avec succès et si l’implémentation de LUA Windows peut prendre en charge le numéro de version spécifié. Si la valeur est égale à zéro, elle a été inscrite avec succès et la version spécifiée peut être prise en charge. Dans le cas contraire, le code de retour est l’un des suivants :

WLUASYSNOTREADY
Le système réseau sous-jacent n’est pas prêt pour la communication réseau.

WLUAVERNOTSUPPORTED
la version de Windows prise en charge du lua demandée n’est pas fournie par cette implémentation de Windows lua particulière.

WLUAINVALID
la version Windows LUA spécifiée par l’application n’est pas prise en charge par cette bibliothèque de liens dynamiques (DLL).

WLUAFAILURE
une erreur s’est produite lors de l’initialisation de la DLL LUA Windows. Cela se produit généralement en raison de l’échec d’un appel du système d’exploitation.

WLUAINITREJECT
WinRUIStartup a été appelé plusieurs fois.

Notes

pour prendre en charge les futures implémentations et applications de LUA de Windows susceptibles d’avoir des différences de fonctionnalités, une négociation a lieu dans WinRUIStartup. une application passe à WinRUIStartup la version Windows LUA qu’elle peut utiliser. si cette version est inférieure à la version la plus ancienne prise en charge par la dll LUA Windows, la dll ne peut pas prendre en charge l’application et WinRUIStartup échoue. toutefois, si la version n’est pas inférieure, l’appel se déroule correctement et retourne la version la plus récente de Windows LUA prise en charge par la DLL. si cette version est inférieure à la version la plus ancienne prise en charge par l’application, l’initialisation de l’application échoue ou tente de trouver une autre Windows DLL LUA sur le système.

cette négociation permet à la fois à une Windows DLL lua et à une application Windows lua de prendre en charge une plage de versions Windows lua. Une application peut utiliser correctement une DLL si les versions se chevauchent. Le tableau suivant illustre le fonctionnement de WinRUIStartup conjointement avec différentes versions d’application et de dll.

Versions de l’application LUA Versions de DLL LUA À

WinRUIStartup
Du

WinRUIStartup
Résultat
1.0 1.0 1.0 1.0 Utiliser 1,0
1,0, 2,0 1.0 2,0 1.0 Utiliser 1,0
1.0 1,0, 2,0 1.0 2,0 Utiliser 1,0
1.0 2,0, 3,0 1.0 WLUAINVALID Échec
2,0, 3,0 1.0 3.0 1.0 Échec de l’application
1,0, 2,0, 3,0 1,0, 2,0, 3,0 3,0 3,0 Utiliser 3,0

Notes

L’application qui utilise des verbes RUI doit appeler WinRUIStartup avant d’émettre d’autres commandes lua. Toutefois, WinRUIStartup ne doit être appelé qu’une seule fois par application. Si elle est appelée plusieurs fois, les appels suivants sont rejetés.

Les détails de l’implémentation LUA réelle sont décrits dans la structure WLUADATA , définie comme suit :

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

après avoir effectué la dernière Windows appel LUA, une application doit appeler la routine WinRUICleanup .

Chaque application LUA qui utilise des verbes RUI doit effectuer un appel WinRUIStartup avant d’émettre d’autres appels lua.

Voir aussi

WinRUICleanup