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 |