平台 SDK: 国际特性

IsValidLocale

IsValidLocale函数确定指定的语言环境标识符是否有效。 目前,该功能基于指定的有效性测试来测试呼叫系统上是否安装或支持区域设置标识符。

BOOL IsValidLocale(
  LCID Locale,    // 区域设置标识符
  DWORD dwFlags   // 有效性测试
);

参数

  • Locale

  • [in] 指定要验证的区域设置标识符。 您可以使用MAKELCID宏创建区域设置标识符。

  • dwFlags

  • [in] 指定应用于区域设置标识符的有效性测试。 该参数可以是以下值之一。

    含义
    LCID_INSTALLED测试区域设置标识符是否受支持和安装。
    LCID_SUPPORTED测试语言环境标识符是否受支持。


返回值

如果区域设置标识符通过指定的有效性测试,则返回值是非零值。

如果区域设置标识符未通过指定的有效性测试,则返回值为零。

备注

如果指定了LCID_INSTALLED标志,并且此函数返回非零值,则语言环境标识符在系统上都受支持并安装。 安装LCID意味着此语言环境提供了完整的语言支持级别。 这包括代码页翻译表,键盘布局,字体,排序和区域设置数据。

如果指定了LCID_SUPPORTED并且此函数返回零,则版本中支持区域设置标识符,但不一定在系统上安装。

有关更多信息,请参阅区域设置。

要求

  Windows NT/2000/XP: 包含在Windows NT 3.51和更高版本中。

  Windows 95/98/Me: 包含在Windows 95和更高版本中。

  头文件: 声明于 Winbase.h; 包含于  Windows.h.
  库: 使用 Kernel32.lib.