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)
Library	Kernel32.lib
DLL	Kernel32.dll