WinRUIStartup

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

語法

  
          int WINAPI WinRUIStartup(   
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
WinRUIStartup 多次呼叫。

備註

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

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

LUA 應用程式版本	LUA DLL 版本	收件者 WinRUIStartup	寄件者 WinRUIStartup	結果
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

注意

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

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

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

在進行最後一次 Windows LUA 呼叫之後，應用程式應該呼叫 WinRUICleanup 常式。

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

另請參閱

WinRUICleanup