WinRUIStartup

La funzione WinRUIStartup consente a un'applicazione di usare verbi URI (Request Unit Interface) per specificare la versione dell'applicazione di unità logica windows (LUA) necessaria e per recuperare i dettagli dell'implementazione specifica di Microsoft Windows LUA. Questa funzione deve essere chiamata da un'applicazione per registrarsi con un'implementazione di Windows LUA prima di emettere ulteriori chiamate LUA di Windows.

Sintassi

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

Parametri

wVersionRequired
Specifica la versione del supporto di Windows LUA necessaria. Il byte ad ordine elevato specifica il numero di versione secondaria (revisione). Il byte a basso ordine specifica il numero di versione principale.

lpLuaData
Puntatore alla struttura LUADATA contenente le informazioni sul numero di versione restituito.

Valore restituito

Il codice restituito specifica se l'applicazione è stata registrata correttamente e se l'implementazione di Windows LUA può supportare il numero di versione specificato. Se il valore è zero, è stato registrato correttamente e la versione specificata può essere supportata. In caso contrario, il codice restituito è uno dei seguenti:

WLUASYSNOTREADY
Il sistema di rete sottostante non è pronto per la comunicazione di rete.

WLUAVERNOTSUPPORTED
La versione del supporto di Windows LUA richiesta non è fornita da questa particolare implementazione di Windows LUA.

WLUAINVALID
La versione di Windows LUA specificata dall'applicazione non è supportata da questa libreria di collegamento dinamico (DLL).

WLUAFAILURE
Si è verificato un errore durante l'inizializzazione della DLL luA di Windows. Questo avviene in genere perché una chiamata del sistema operativo non è riuscita.

WLUAINITREJECT
WinRUIStartup è stato chiamato più volte.

Commenti

Per supportare le future implementazioni di Windows LUA e le applicazioni che potrebbero avere differenze di funzionalità, viene eseguita una negoziazione in WinRUIStartup. Un'applicazione passa a WinRUIStartup la versione di Windows LUA che può essere usata. Se questa versione è inferiore alla versione più bassa supportata dalla DLL di Windows LUA, la DLL non può supportare l'applicazione e WinRUIStartup ha esito negativo. Se la versione non è inferiore, tuttavia, la chiamata ha esito positivo e restituisce la versione più alta di Windows LUA supportata dalla DLL. Se questa versione è inferiore alla versione più bassa supportata dall'applicazione, l'applicazione ha esito negativo o tenta di trovare un'altra DLL di Windows LUA nel sistema.

Questa negoziazione consente sia a una DLL di Windows LUA che a un'applicazione Windows LUA di supportare un'ampia gamma di versioni di Windows LUA. Un'applicazione può usare correttamente una DLL se è presente una sovrapposizione nelle versioni. La tabella seguente illustra il funzionamento di WinRUIStartup insieme a diverse versioni dell'applicazione e della DLL.

Versioni dell'app LUA	Versioni della DLL LUA	Per WinRUIStartup	Da WinRUIStartup	Risultato
1.0	1.0	1.0	1.0	Usare 1.0
1.0, 2.0	1,0	2,0	1.0	Usare 1.0
1.0	1.0, 2.0	1.0	2,0	Usare 1.0
1.0	2.0, 3.0	1.0	WLUAINVALID	Esito negativo
2.0, 3.0	1.0	3.0	1.0	L'app ha esito negativo
1.0, 2.0, 3.0	1.0, 2.0, 3.0	3,0	3,0	Usare 3.0

Nota

L'applicazione che usa verbi URI deve chiamare WinRUIStartup prima di emettere altri comandi LUA. Tuttavia, WinRUIStartup deve essere chiamato una sola volta per applicazione. Se viene chiamato più volte, le chiamate successive verranno rifiutate.

I dettagli dell'implementazione effettiva di LUA sono descritti nella struttura WLUADATA , definita come segue:

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

Dopo aver effettuato l'ultima chiamata di Windows LUA, un'applicazione deve chiamare la routine WinRUICleanup .

Ogni applicazione LUA che usa verbi RUI deve effettuare una chiamata WinRUIStartup prima di inviare altre chiamate LUA.

Vedere anche

WinRUICleanup