共用方式為

EnumSystemLocalesA 函式 （winnls.h）

  • 發行項

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

注意 基於互操作性考慮，應用程式應該偏好使用 EnumSystemLocalesEx 函式來 EnumSystemLocales，因為Microsoft正移轉至使用地區設定名稱，而不是新地區設定的地區設定標識符。 只有在 Windows Vista 和更新版本上執行的任何應用程式都應該使用 EnumSystemLocalesEx。
 

語法

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

參數

[in] lpLocaleEnumProc

應用程式定義回呼函式的指標。 如需詳細資訊，請參閱 EnumLocalesProc。

[in] dwFlags

指定要列舉的地區設定標識碼的旗標。 旗標可以搭配二進位 OR 使用或結合。 如果應用程式為此參數指定 0，則函式的行為會與 LCID_SUPPORTED 一樣。

價值 意義
LCID_INSTALLED
 僅列舉已安裝的地區設定標識碼。 這個值不能與LCID_SUPPORTED搭配使用。
LCID_SUPPORTED
 列舉所有支持的地區設定標識碼。 這個值不能與LCID_INSTALLED搭配使用。
LCID_ALTERNATE_SORTS
 只列舉替代排序地區設定標識碼。 如果此值與LCID_INSTALLED或LCID_SUPPORTED搭配使用，則會擷取已安裝或支援的地區設定，以及替代的排序地區設定標識符。

傳回值

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

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

言論

函式會一次將地區設定標識碼傳遞至指定的應用程式定義回呼函式，以列舉地區設定。 這會繼續執行，直到所有已安裝或支援的地區設定識別碼都傳遞至回呼函式，或回呼函式傳回 FALSE。

注意

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

要求

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

另請參閱

EnumLocalesProc

EnumSystemLocalesEx

國家語言支援

國家語言支援函式