DownlevelLocaleNameToLCID 函数

区域设置名称转换为区域设置标识符,可使用该标识符从操作系统获取信息。

注意

此函数仅由在 Windows Vista 之前的操作系统上运行的应用程序使用。 它的使用需要下载包。 仅在 Windows Vista 及更高版本上运行的应用程序应调用 LocaleNameToLCID 来检索区域设置标识符

 

语法

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

参数

lpName [in]

指向表示区域设置名称的以 null 结尾的字符串的指针。

dwFlags [in]

指定名称类型的标志。 默认值为 DOWNLEVEL_LOCALE_NAME。

返回值

成功时返回与区域设置名称相对应的区域设置标识符。

如果此函数不成功,则返回 0。 若要获取扩展错误信息,可以让应用程序调用 GetLastError,它可能会返回以下错误代码之一:

  • ERROR_INVALID_FLAGS。 为标志提供的值无效。
  • ERROR_INVALID_PARAMETER。 任何参数值无效。

备注

注意

此函数不支持非特定区域设置。 等效 LocaleNameToLCID 函数支持自定义区域设置,但仅适用于 Windows Vista 及更高版本。

 

所需的头文件和 DLL 是“Microsoft NLS 下层数据映射 API”下载的一部分,该下载已不再从 Microsoft 下载中心提供。 在 Windows 10 2019 年 5 月更新及更高版本上使用 ICU 全球化 API

要求

要求
最低受支持的客户端
Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
可再发行组件
带 SP2 及更高版本的 Windows XP 或 Windows Vista 上的 Microsoft NLS 下层数据映射 API
标头
Nlsdl.h
DLL
NlsMap.dll

另请参阅

区域语言支持

区域语言支持函数

映射区域设置数据

LocaleNameToLCID