WinSLIStartup

WinSLIStartup函式可讓應用程式使用工作階段層級介面 (SLI) 動詞來指定所需的 Microsoft Windows 邏輯單元應用程式版本 (LUA) ，以及擷取特定 Windows LUA 實作的詳細資料。 應用程式必須呼叫此函式，才能向 Windows LUA 實作註冊本身，再發出任何進一步的 Windows LUA 呼叫。

語法

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

參數

wVersionRequired
指定所需的 Windows LUA 支援版本。 高序位元組會指定次要版本 (修訂) 號碼。 低序位元組會指定主要版本號碼。

lpLuaData
包含傳回版本號碼資訊的 LUADATA 結構的指標。

傳回值

傳回碼會指定應用程式是否已成功註冊，以及 Windows LUA 實作是否可以支援指定的版本號碼。 如果值為零，則已成功註冊該值，而且可以支援指定的版本。 否則，傳回碼是下列其中一項：

WLUASYSNOTREADY
基礎網路系統尚未準備好進行網路通訊。

WLUAVERNOTSUPPORTED
此特定 Windows LUA 實作未提供所要求的 Windows LUA 支援版本。

WLUAINVALID
此動態連結程式庫不支援應用程式指定的 Windows LUA 版本 (DLL) 。

WLUAFAILURE
Windows LUA DLL 初始化時發生失敗。 這通常是因為作業系統呼叫失敗。

WLUAINITREJECT
WinSLIStartup 多次呼叫。

備註

為了支援未來可能有功能差異的 Windows LUA 實作和應用程式， 在 WinSLIStartup中會進行交涉。 應用程式會傳遞至 WinSLIStartup 它可以使用的 Windows LUA 版本。 如果此版本低於 Windows LUA DLL 支援的最低版本，則 DLL 無法支援應用程式， 而 WinSLIStartup 會失敗。 不過，如果版本不較低，則呼叫會成功，並傳回 DLL 支援的最高 Windows LUA 版本。 如果此版本低於應用程式支援的最低版本，則應用程式會失敗初始化，或嘗試在系統上尋找另一個 Windows LUA DLL。

此交涉可讓 Windows LUA DLL 和 Windows LUA 應用程式支援一系列 Windows LUA 版本。 如果版本有任何重迭，應用程式就可以成功使用 DLL。 下表說明 WinSLIStartup 如何搭配不同的應用程式和 DLL 版本運作。

應用程式版本	LUA DLL 版本	收件者 WinSLIStartup	寄件者 WinSLIStartup	結果
1.0	1.0	1.0	1.0	使用 1.0
1.0, 2.0	1.0	2.0	1.0	使用 1.0
1.0	1.0, 2.0	1.0	2.0	使用 1.0
1.0	2.0, 3.0	1.0	WLUAINVALID	失敗
2.0, 3.0	1.0	3.0	1.0	應用程式失敗
1.0, 2.0, 3.0	1.0, 2.0, 3.0	3.0	3.0	使用 3.0

注意

使用 SLI 動詞的應用程式必須先呼叫 WinSLIStartup ，才能發出任何其他 LUA 命令。 不過，每個應用程式只需要呼叫 WinSLIStartup 一次。 如果呼叫多次，後續的呼叫將會遭到拒絕。

實際 LUA 實作的詳細資料會在 WLUADATA 結構中說明，如下所示：

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

完成最後一個 Windows LUA 呼叫後，應用程式應該呼叫 WinSLICleanup 常式。

使用 SLI 動詞的每個 LUA 應用程式都必須進行 WinSLIStartup 呼叫，才能發出任何其他 LUA 呼叫。

另請參閱

WinSLICleanup