LCIDToLocaleName 函数 (winnls.h)

将区域设置 标识符 转换为 区域设置名称

注意 对于自定义区域设置(包括 Microsoft 创建的区域设置),应用程序应首选区域设置名称而不是区域设置标识符。

 

语法

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

参数

[in] Locale

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

Windows Vista: 还支持以下自定义区域设置标识符。

[out, optional] lpName

指向缓冲区的指针,此函数在其中检索区域设置名称或以下预定义值之一。

[in] cchName

区域设置名称缓冲区的大小(以字符为单位)。 区域设置名称的最大可能长度(包括终止 null 字符) LOCALE_NAME_MAX_LENGTH。 这是为此参数提供的建议大小。

或者,应用程序可以将此参数设置为 0。 在这种情况下,函数返回区域设置名称缓冲区所需的大小。

[in] dwFlags

在 Windows 7 之前: 保留;应始终为 0。

从 Windows 7 开始: 可以设置为 LOCALE_ALLOW_NEUTRAL_NAMES 以允许返回非特定名称。

返回值

如果成功,则返回区域设置名称中的字符计数,包括终止 null 字符。 如果函数成功且 cchName 的值为 0,则返回值是区域设置名称缓冲区所需的大小(以字符 (包括 null) )。

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

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

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 winnls.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

LocaleNameToLCID

国家/地区语言支持

国家/地区语言支持函数