getUserDefaultLocaleName 函数 (winnls.h)

检索用户默认 区域设置名称

注意 如果设计为仅在 Windows Vista 及更高版本上运行,应用程序应优先调用此函数,而不是 GetUserDefaultLCID

 

语法

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

参数

[out] lpLocaleName

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

[in] cchLocaleName

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

返回值

如果成功,则返回包含区域设置名称(包括终止 null 字符)的缓冲区的大小。

注意 在单用户系统上,返回值与 GetSystemDefaultLocaleName 返回的值相同。

 

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

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

注解

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

要求

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

另请参阅

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

国家/地区语言支持

国家/地区语言支持函数