WinSLIStartup

Die WinSLIStartup-Funktion ermöglicht es einer Anwendung, die die SLI-Verben (Session Level Interface) verwendet, die erforderliche Version der Microsoft Windows Logical Unit Application (LUA) anzugeben und Details zur spezifischen Windows LUA-Implementierung abzurufen. Diese Funktion muss von einer Anwendung aufgerufen werden, um sich selbst bei einer Windows LUA-Implementierung zu registrieren, bevor weitere Windows LUA-Aufrufe ausgegeben werden.

Syntax

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

Parameter

wVersionRequired
Gibt die erforderliche Version der Windows LUA-Unterstützung an. Das Byte mit hoher Ordnung gibt die Nummer der Nebenversion (Revision) an. Das Byte in niedriger Reihenfolge gibt die Hauptversionsnummer an.

lpLuaData
Zeiger auf die LUADATA-Struktur , die die zurückgegebenen Versionsnummerninformationen enthält.

Rückgabewert

Der Rückgabecode gibt an, ob die Anwendung erfolgreich registriert wurde und ob die Windows LUA-Implementierung die angegebene Versionsnummer unterstützen kann. Wenn der Wert null ist, wurde er erfolgreich registriert, und die angegebene Version kann unterstützt werden. Andernfalls lautet der Rückgabecode wie folgt:

WLUASYSNOTREADY
Das zugrunde liegende Netzwerksystem ist nicht bereit für die Netzwerkkommunikation.

WLUAVERNOTSUPPORTED
Die angeforderte Version der Windows LUA-Unterstützung wird von dieser speziellen Windows LUA-Implementierung nicht bereitgestellt.

WLUAINVALID
Die von der Anwendung angegebene Windows-LUA-Version wird von dieser DLL (Dynamic Link Library) nicht unterstützt.

WLUAFAILURE
Fehler beim Initialisieren der Windows LUA-DLL. Dies tritt in der Regel auf, weil ein Betriebssystemaufruf fehlgeschlagen ist.

WLUAINITREJECT
WinSLIStartup wurde mehrmals aufgerufen.

Hinweise

Um zukünftige Windows LUA-Implementierungen und -Anwendungen zu unterstützen, die möglicherweise Funktionsunterschiede aufweisen, findet in WinSLIStartup eine Aushandlung statt. Eine Anwendung übergibt an WinSLIStartup die Windows LUA-Version, die sie verwenden kann. Wenn diese Version niedriger ist als die niedrigste Version, die von der Windows LUA-DLL unterstützt wird, kann die DLL die Anwendung nicht unterstützen, und WinSLIStartup schlägt fehl. Wenn die Version jedoch nicht niedriger ist, ist der Aufruf erfolgreich und gibt die höchste Version von Windows LUA zurück, die von der DLL unterstützt wird. Wenn diese Version niedriger als die niedrigste von der Anwendung unterstützte Version ist, schlägt die Initialisierung der Anwendung fehl oder versucht, eine andere Windows LUA-DLL auf dem System zu finden.

Diese Aushandlung ermöglicht es sowohl einer Windows LUA-DLL als auch einer Windows LUA-Anwendung, eine Reihe von Windows LUA-Versionen zu unterstützen. Eine Anwendung kann erfolgreich eine DLL verwenden, wenn sich die Versionen überschneiden. In der folgenden Tabelle wird veranschaulicht, wie WinSLIStartup in Verbindung mit verschiedenen Anwendungs- und DLL-Versionen funktioniert.

App-Versionen	LUA-DLL-Versionen	Beschreibung WinSLIStartup	From WinSLIStartup	Ergebnis
1.0	1.0	1.0	1.0	Verwenden von 1.0
1.0, 2.0	1.0	2.0	1.0	Verwenden von 1.0
1.0	1.0, 2.0	1.0	2.0	Verwenden von 1.0
1.0	2.0, 3.0	1.0	WLUAINVALID	Fehler
2.0, 3.0	1.0	3.0	1.0	App schlägt fehl
1.0, 2.0, 3.0	1.0, 2.0, 3.0	3.0	3.0	Verwenden von 3.0

Hinweis

Die Anwendung, die SLI-Verben verwendet, muss WinSLIStartup aufrufen, bevor andere LUA-Befehle ausgegeben werden. WinSLIStartup muss jedoch nur einmal pro Anwendung aufgerufen werden. Wenn es mehrmals aufgerufen wird, werden die nachfolgenden Aufrufe abgelehnt.

Details zur tatsächlichen LUA-Implementierung werden in der WLUADATA-Struktur beschrieben, die wie folgt definiert ist:

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

Nach dem letzten Windows LUA-Aufruf sollte eine Anwendung die WinSLICleanup-Routine aufrufen.

Jede LUA-Anwendung, die SLI-Verben verwendet, muss einen WinSLIStartup-Aufruf ausführen, bevor andere LUA-Aufrufe ausgeführt werden.

Weitere Informationen

WinSLICleanup