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，它可能会返回以下错误代码之一：
- ERROR_INSUFFICIENT_BUFFER。 提供的缓冲区大小不够大，或者错误地设置为 NULL。
- ERROR_INVALID_PARAMETER。 任何参数值无效。
备注
所需的头文件和 DLL 是“Microsoft NLS 下层数据映射 API”下载的一部分，该下载已不再从 Microsoft 下载中心提供。 在 Windows 10 2019 年 5 月更新及更高版本上使用 ICU 全球化 API。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows XP [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
| 可再发行组件 |
带 SP2 的 Windows XP 及更高版本上的 Microsoft NLS 下层数据映射 API |
| Header |
|
| DLL |
|
另请参阅