LCIDToLocaleName 函数 (winnls.h)

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

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

 

语法

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

参数

[in] Locale

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

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

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

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[out, optional] lpName

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

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[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

国家/地区语言支持

国家/地区语言支持函数