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 [僅限桌面應用程式]
目標平台 Windows
標頭 winnls.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

EnumLocalesProc

EnumSystemLocalesEx

國家語言支援

國家語言支援函式