DownlevelGetParentLocaleName 函数

检索提供的区域设置的父级的区域设置名称。

注意

此函数仅供 Windows Vista 之前的操作系统上运行的应用程序使用。使用它需要下载包。仅在 Windows Vista 及更高版本上运行的应用程序应调用 GetLocaleInfo，并将 LCType 设置为 LOCALE_SPARENT。

语法

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

Locale [in]

区域设置的区域设置标识符。可以使用 MAKELCID 宏创建区域设置标识符或使用以下预定义值之一。

Windows Vista 及更高版本：还支持以下自定义区域设置标识符。

lpName [out]

指向某个缓冲区的指针，函数在该缓冲区中检索父区域设置名称或以下预定义值之一。如果 cchName 设置为 0，则此参数设置为 NULL。

cchName [in]

由 lpName 指示的缓冲区的大小，以 UTF-16 码位表示。此参数的值为 0 将导致该函数忽略 lpName 缓冲区并返回缓冲区的大小（以字符为单位，包括 null 字符），要包含父区域设置名称，必须指定此参数。

返回区域设置名称中的 UTF-16 码位计数，包括终止 null 字符（如果成功）。

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

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

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