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