EnumUILanguagesA 函式（winnls.h）

發行項
11/20/2024

列舉操作系統上可用的使用者介面語言，並使用清單中的每種語言呼叫回調函式。

語法

BOOL EnumUILanguagesA(
  [in] UILANGUAGE_ENUMPROCA lpUILanguageEnumProc,
  [in] DWORD                dwFlags,
  [in] LONG_PTR             lParam
);

參數

[in] lpUILanguageEnumProc

應用程式定義的 EnumUILanguagesProc 回呼函式的指標。 EnumUILanguages 重複呼叫此函式，以列舉清單中的語言。

[in] dwFlags

識別語言格式和篩選的旗標。下列旗標會指定要傳遞至回呼函式的語言格式。格式旗標互斥，MUI_LANGUAGE_ID為預設值。

價值	意義
MUI_LANGUAGE_ID	將語言字串中的語言識別碼傳遞至回呼函式。
MUI_LANGUAGE_NAME	將語言字串中的語言名稱傳遞至回呼函式。

下列旗標會指定要用於列舉語言之函式的篩選。篩選旗標互斥，預設值為MUI_LICENSED_LANGUAGES。

價值	意義
MUI_ALL_INSTALLED_LANGUAGES	列舉操作系統可用的所有已安裝語言。
MUI_LICENSED_LANGUAGES	列舉所有可用且已授權使用的語言。
MUI_GROUP_POLICY	列舉所有可用和授權的已安裝語言，以及允許的語言組策略。

Windows Vista 和更新版本： 應用程式可以將 dwFlags 設定為 0，或設定為一或多個指定的旗標。設定為 0 會導致參數值預設為 MUI_LANGUAGE_ID |MUI_LICENSED_LANGUAGES。

Windows 2000、Windows XP、Windows Server 2003： 應用程式必須將 dwFlags 設為 0。

[in] lParam

應用程式定義的值。

傳回值

如果成功或 FALSE 則傳回 TRUE TRUE。若要取得擴充的錯誤資訊，應用程式可以呼叫 getLastError，以傳回下列其中一個錯誤碼：

ERROR_INVALID_FLAGS。為旗標的值無效。
ERROR_INVALID_PARAMETER。任何參數值都無效。

言論

此函式會列舉可用的使用者介面語言，並視指定之旗標而定，授權用於操作系統。它會一次將語言標識碼或語言名稱傳遞至 EnumUILanguagesProc 回呼函式。 EnumUILanguages 函式會繼續將語言標識碼或名稱傳遞至回呼函式，直到找到最後一種語言或回呼函式傳回 FALSE為止。

針對只在 Windows Vista 和更新版本上執行的應用程式，建議透過 MUI_LANGUAGE_ID 使用MUI_LANGUAGE_NAME。 MUI_LANGUAGE_NAME可讓您區分與補充地區設定相關聯的語言。

如果在呼叫此函式時指定MUI_LANGUAGE_ID旗標，則傳遞至回呼的字串

函式會是不包含前置 0x 的十六進位語言標識碼，而且會是 4

長度為字元。例如，en-US 會傳遞為 “0409”，en 為 “0009”。值「1000」會針對與補充地區設定相關聯的任何語言傳遞至回呼函式。這個值對應於 LOCALE_CUSTOM_UNSPECIFIED的十六進位值。即使選取的語言位於使用者慣用UI語言清單或系統慣用UI語言清單中，它也不會區分補充地區設定。

C# 簽章

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean EnumUILanguages(
            EnumUILanguagesProc lpUILanguageEnumProc,
            System.UInt32 dwFlags,
            System.IntPtr lParam
            );

注意

winnls.h 標頭會將 EnumUILanguages 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
支援的最低伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平臺	窗戶
標頭	winnls.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll