DownlevelLCIDToLocaleName 函数

注意

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

语法

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Locale [in]

要转换的区域设置标识符。可以使用 MAKELCID 宏创建区域设置标识符。此函数不支持非特定区域设置或以下特定区域设置标识符值。

lpName [out]

指向缓冲区的指针，此函数在其中检索区域设置名称。如果 cchName 设置为 0，则该函数将检索 NULL。

cchName [in]

区域设置名称缓冲区的的大小（UTF-16 码位）。应用程序将此参数设置为 0，以返回区域设置名称缓冲区所需的大小。

dwFlags [in]

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

返回区域设置名称中的 UTF-16 码位计数，包括 null 终止字符（如果成功）。如果函数成功且 cchName 的值为 0，则返回值是区域设置名称缓冲区所需的大小（以字符为单位，包括 null 字符）。

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

注意

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

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