DownlevelGetParentLocaleName 函数

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

注意

此函数仅由在预Windows Vista 操作系统上运行的应用程序使用。 它的使用需要下载包。 仅在 Windows Vista 及更高版本上运行的应用程序应调用设置为 LOCALE_SPARENT的 LCTypeGetLocaleInfo

 

语法

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

参数

区域设置 [in]

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

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

lpName [out]

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

cchName [in]

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

返回值

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

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

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

备注

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

要求

要求
最低受支持的客户端
Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
可再发行组件
Microsoft NLS Downlevel Data Mapping API onWindows XP with SP2 及更高版本
标头
Nlsdl.h
DLL
NlsMap.dll

另请参阅

国家语言支持

国家语言支持函数

映射区域设置数据

GetLocaleInfo