EnumSystemLocalesEx 函式 (winnls.h)

列舉操作系統所安裝或支援的地區設定。

注意 如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該優先呼叫此函 式給 EnumSystemLocales 。

 

語法

BOOL EnumSystemLocalesEx(
  [in]           LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
  [in]           DWORD             dwFlags,
  [in]           LPARAM            lParam,
  [in, optional] LPVOID            lpReserved
);

參數

[in] lpLocaleEnumProcEx

應用程式定義回呼函式的指標。 EnumSystemLocalesEx 函式會透過對這個回呼函式進行重複呼叫來列舉地區設定。 如需詳細資訊，請參閱 EnumLocalesProcEx。

[in] dwFlags

識別要列舉之地區設定的旗標。 旗標可以透過 Singly 使用，或使用二進位 OR 結合。 如果應用程式為此參數指定 0，則函式的行為會如同 LOCALE_ALL。

• LOCALE_ALL
• LOCALE_ALTERNATE_SORTS;請參閱備註
• LOCALE_NEUTRALDATA
• LOCALE_SUPPLEMENTAL
• LOCALE_WINDOWS

[in] lParam

要傳遞至回呼函式的應用程式提供參數。 這特別適用於多線程應用程式。

[in, optional] lpReserved

保留;必須是 NULL。

傳回值

如果成功，則傳回非零值，否則傳回 0。 若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：

• ERROR_BADDB。 函式無法存取數據。 這種情況通常不應該發生，通常表示安裝不正確、磁碟問題或類似。
• ERROR_INVALID_FLAGS。 為旗標的值無效。
• ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

此函式會一次將地區設定名稱傳遞至 lpLocaleEnumProcEx 所指定的應用程式定義回呼函式，藉以列舉地區設定。 列舉會繼續執行，直到所有已安裝或支援的名稱都傳遞至回呼函式，否則回呼函式會傳回 FALSE。

dwFlags 參數的選項與 EnumSystemLocales 的選項不同，這必須區分已安裝及支援的地區設定。

如果 dwFlags 指定 LOCALE_ALTERNATE_SORTS，則會針對代表替代排序順序的每個地區設定呼叫回呼函式。 例如，西班牙文 (西班牙) 預設為國際排序順序，但傳統的排序順序可用於替代排序。 德文 (德國) 預設為字典排序順序，但有替代的電話簿排序順序可供使用。

範例

此函式的使用範例可在 NLS：名稱型 API 範例中找到。

規格需求

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	winnls.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

EnumLocalesProcEx

EnumSystemLocales

國家語言支援

國家語言支援函式