WinSLIStartup
La funzione WinSLIStartup consente a un'applicazione di usare i verbi SLI (Session Level Interface) per specificare la versione dell'applicazione di unità logica di Microsoft Windows (LUA) necessaria e per recuperare i dettagli dell'implementazione specifica di 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 WinSLIStartup(
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
WinSLIStartup è 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 WinSLIStartup. Un'applicazione passa a WinSLIStartup 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 WinSLIStartup 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 WinSLIStartup insieme a diverse versioni di applicazione e DLL.
| Versioni delle app | Versioni della DLL LUA | Per WinSLIStartup |
Da WinSLIStartup |
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 SLI deve chiamare WinSLIStartup prima di emettere altri comandi LUA. Tuttavia, WinSLIStartup 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 WinSLICleanup .
Ogni applicazione LUA che usa verbi SLI deve effettuare una chiamata WinSLIStartup prima di inviare altre chiamate LUA.