isValidLocale 函式 (winnls.h)

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

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

語法

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

[in] Locale

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

LOCALE_CUSTOM_DEFAULTWindows Server 2003、Windows XP 和 Windows 2000：不支援此地區設定標識符。
LOCALE_CUSTOM_UI_DEFAULTWindows Server 2003、Windows XP 和 Windows 2000：不支援此地區設定標識符。
LOCALE_CUSTOM_UNSPECIFIEDWindows Server 2003、Windows XP 和 Windows 2000：不支援此地區設定標識符。
LOCALE_INVARIANT
LOCALE_SYSTEM_DEFAULT
LOCALE_USER_DEFAULT

[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