DownlevelGetParentLocaleName 函数

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

备注

此函数仅由在预部署 Vista 操作系统Windows应用程序使用。 其使用需要下载包。 仅在 Vista 和更高版本Windows运行的应用程序应调用 GetLocaleInfo,并且 LCType 设置为 LOCALE _ SPARENT

语法

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

参数

区域设置 []

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

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

lpName [out]

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

cchName []

lpName 指示的缓冲区大小,以 UTF-16 码位表示。 此参数的值为 0 会导致函数忽略 lpName 缓冲区,并返回缓冲区的大小(以字符 (包含的 null 字符) ,其中包含父区域设置名称。

返回值

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

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

  • 缓冲区 _ 不足 _ 错误。 提供的缓冲区大小不够大,或者错误地设置为 NULL。
  • 错误 _ 参数 _ 无效。 任何参数值都无效。

备注

所需的头文件和 DLL 是 Microsoft 下载中心提供的"Microsoft NLS 下层数据映射 API"下载 的一部分

要求

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

请参阅

国家语言支持

国家语言支持函数

映射区域设置数据

GetLocaleInfo