isValidLocaleName 函数 (winnls.h)

确定指定的 区域设置名称 对于操作系统上安装或支持的区域设置是否有效。

注意 仅在 Windows Vista 及更高版本上运行的应用程序应优先调用此函数,而不是 IsValidLocale ,以确定 补充区域设置的有效性。

 

语法

BOOL IsValidLocaleName(
  [in] LPCWSTR lpLocaleName
);

参数

[in] lpLocaleName

指向要验证的区域设置名称的指针。

返回值

如果区域设置名称有效,则返回非零值;如果名称无效,则返回 0。

注解

在 Windows Vista 及更高版本上,所有受支持的区域设置都应安装在所有操作系统上。

此函数可以处理 自定义区域设置的名称。 不保证数据在计算机之间或应用程序运行之间的数据相同。 如果应用程序必须保留或传输数据,请参阅 使用持久区域设置数据

从 Windows 8 开始: 如果你的应用将语言标记从 Windows.Globalization 命名空间传递到此函数,它必须首先通过调用 ResolveLocaleName 来转换标记。

示例

可在 NLS 中找到显示此函数用法的示例 :基于名称的 API 示例

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 winnls.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

GetLocaleInfoEx

IsValidLocale

国家/地区语言支持

国家/地区语言支持函数