共用方式為


isValidLocale 函式 (winnls.h)

[IsValidLocale 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 IsValidLocaleName 來判斷 補充地區設定的有效性。]

判斷作業系統上是否已安裝或支援指定的地區設定。 如需詳細資訊,請參閱 地區設定和語言

語法

BOOL IsValidLocale(
  [in] LCID  Locale,
  [in] DWORD dwFlags
);

參數

[in] Locale

要驗證的地區設定地區設定標識碼。 您可以使用 MAKELCID 宏來建立地區設定標識碼,或使用下列其中一個預先定義的值。

[in] dwFlags

指定要套用至地區設定標識碼之有效測試的旗標。 此參數可以有下列其中一個值。

意義
LCID_INSTALLED
判斷是否同時支援並安裝地區設定標識碼。
LCID_SUPPORTED
判斷是否支援地區設定標識碼。
0x39
請勿使用。 請改用 LCID_INSTALLED。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP 和 Windows 2000: dwFlags 設定為 0x39 是一種特殊案例,其行為可能會像某些 Windows 版本上的某些地區設定LCID_INSTALLED一樣。

傳回值

如果地區設定標識碼通過指定的有效度測試,則傳回非零值。 如果函式不成功,函式會傳回 0。

備註

如果指定了 LCID_INSTALLED 旗標,而且此函式會傳回非零值,則會同時支援地區設定標識碼,並安裝在操作系統上。 安裝標識元表示指定的地區設定可以使用完整的語言支援層級。 完整支援包括代碼頁翻譯表格、鍵盤配置、字型,以及排序和地區設定數據。

如果指定LCID_SUPPORTED,而且此函式會傳回 0,則版本支援地區設定標識碼,但不一定安裝在操作系統上。

此函式可以處理 來自自定義地區設定的數據。 數據不保證從計算機到計算機或在應用程式執行之間相同。 如果您的應用程式必須保存或傳輸數據,請參閱 使用持續性地區設定數據

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winnls.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

GetLocaleInfo

IsValidLocaleName

國家語言支援

國家語言支援函式