WinRUIStartup

La funzione WinRUIStartup consente a un'applicazione che usa verbi RUI (Request Unit Interface) di specificare la versione di Windows logical unit application (LUA) necessaria e di recuperare i dettagli dell'implementazione LUA di Microsoft Windows specifica. Questa funzione deve essere chiamata da un'applicazione per registrarsi con un'implementazione LUA Windows prima di eseguire altre Windows lua.

Sintassi

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

Parametri

wVersionRequired
Specifica la versione di Windows supporto LUA richiesto. Il byte più significativo specifica il numero di versione secondaria (revisione). Il byte di ordine più basso specifica il numero di versione principale.

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

Valore restituito

Il codice restituito specifica se l'applicazione è stata registrata correttamente e se l'Windows'implementazione 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 Windows LUA richiesta non è fornita da questa specifica implementazione lua Windows LUA.

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

WLUAFAILURE
Errore durante l'inizializzazione Windows DLL LUA. Ciò si verifica in genere perché una chiamata al sistema operativo non è riuscita.

WLUAINITREJECT
WinRUIStartup è stato chiamato più volte.

Commenti

Per supportare le Windows e le applicazioni LUA che potrebbero avere differenze di funzionalità, viene verificata una negoziazione in WinRUIStartup. Un'applicazione passa a WinRUIStartup Windows versione LUA che può usare. Se questa versione è inferiore alla versione più bassa supportata dalla DLL LUA di Windows, 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ù Windows LUA supportata dalla DLL. Se questa versione è inferiore alla versione più bassa supportata dall'applicazione, l'applicazione non viene inizializzata o tenta di trovare un'altra DLL LUA Windows nel sistema.

Questa negoziazione consente sia a una DLL LUA Windows che a un'applicazione LUA Windows di supportare una gamma di Windows LUA. Un'applicazione può usare correttamente una DLL in caso di sovrapposizione nelle versioni. La tabella seguente illustra il funzionamento di WinRUIStartup in combinazione con diverse versioni di applicazioni e DLL.

Versioni delle app LUA Versioni DLL LUA Per

WinRUIStartup
Da

WinRUIStartup
Risultato
1.0 1.0 1.0 1.0 Usare la versione 1.0
1.0, 2.0 1,0 2,0 1.0 Usare la versione 1.0
1.0 1.0, 2.0 1,0 2,0 Usare la versione 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 la versione 3.0

Nota

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

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

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

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

Ogni applicazione LUA che usa verbi RUI deve effettuare una chiamata WinRUIStartup prima di eseguire qualsiasi altra chiamata LUA.

Vedere anche

WinRUICleanup