getSystemDefaultLocaleName 函数 (winnls.h)

检索系统默认 区域设置名称。

注意 建议应用程序优先调用 GetUserDefaultLocaleName 而不是此函数。 这是因为用户区域设置通常比系统区域设置更有用、更准确。

 

注意 如果设计为仅在 Windows Vista 及更高版本上运行，则应用程序应优先调用 GetSystemDefaultLCID 此函数。

 

语法

int GetSystemDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

参数

[out] lpLocaleName

指向此函数在其中检索区域设置名称的缓冲区的指针。

[in] cchLocaleName

lpLocaleName 指示的输出缓冲区的大小（以字符为单位）。 区域设置名称 (包括终止 null 字符) 的最大可能字符长度为 LOCALE_NAME_MAX_LENGTH。 这是建议的大小。

返回值

如果成功，则返回一个大于 0 的值，该值指示区域设置名称的长度，包括终止 null 字符。

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

• ERROR_INSUFFICIENT_BUFFER。 提供的缓冲区大小不够大，或者错误地设置为 NULL。

注解

此函数可以从 自定义区域设置检索数据。 不保证数据在计算机之间或应用程序运行之间的数据相同。 如果应用程序必须保留或传输数据，请参阅 使用永久性区域设置数据。

示例

可以在 NLS：基于名称的 API 示例中找到显示此函数用法的示例。

要求

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

另请参阅

DownlevelLCIDToLocaleName

GetLocaleInfoEx

GetUserDefaultLocaleName

映射区域设置数据

国家语言支持

国家语言支持函数