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
這個動態連結程式庫 (DLL) 不支援應用程式所指定的 Windows LUA 版本。

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