WinRUIStartup

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

Sintassi

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

Parametri

wVersionRequired
Specifica la versione del supporto luA di Windows richiesto. Il byte di 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 luA di Windows 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 LUA di Windows richiesta non è fornita da questa particolare implementazione LUA di Windows.

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

WLUAFAILURE
Si è verificato un errore durante l'inizializzazione della DLL LUA di Windows. Questo errore si verifica in genere perché una chiamata al sistema operativo non è riuscita.

WLUAINITREJECT
WinRUIStartup è stato chiamato più volte.

Osservazioni:

Per supportare future implementazioni e applicazioni luA di Windows che potrebbero avere differenze di funzionalità, viene eseguita una negoziazione in WinRUIStartup. Un'applicazione passa a WinRUIStartup la versione lua di Windows 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ù recente di Windows LUA supportata dalla DLL. Se questa versione è inferiore alla versione più bassa supportata dall'applicazione, l'applicazione non riesce l'inizializzazione o tenta di trovare un'altra DLL LUA di Windows nel sistema.

Questa negoziazione consente sia a una DLL LUA windows che a un'applicazione WINDOWS LUA di supportare una gamma di versioni LUA di Windows. 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.

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'ultima chiamata a Windows 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