GetLocaleInfo

原文链接 -> 传送门

函数功能：

GetLocaleInfo 函数用于获取标识符指定的区域设置相关信息。

注意：为了互通性，应用程序应该更倾向于使用 GetLocaleInfoEx 函数而不是 GetLocaleInfo，因为对于新的区域，微软逐渐向使用区域的名字来代替区域标识符。任何在  Windows Vista 和之后版本的应用程序都应该使用 GetLocaleInfoEx 函数。


API 函数原型：

注释：_In_ 说明该参数是输入的。

int GetLocaleInfo(
  _In_      LCID   Locale,
  _In_      LCTYPE LCType,
  _Out_opt_ LPTSTR lpLCData,
  _In_      int    cchData
);

参数解析：

返回值：

1. 如果函数调用成功，并且 cchData 为非 0 值，则返回获取的区域数据缓冲区中字符的个数。如果函数调用成功，cchData 为非 0 值，并且指定了 LOCALE_RETURN_NUMBER，则返回值为获取的数据缓冲区中整形数据的大小（也就是说，对于该函数的 Unicode 版本，返回 2，对于该函数的 ANSI 版本，返回 4）；如果函数调用成功，并且 cchData 的值为 0，则返回值为以字符为单位，获取的区域数据缓冲区的大小。

2. 如果函数调用失败，则返回 0。

获取有关错误的更多信息，请调用 GetLastError 函数，该函数将返回下列的错误代码：

备注：

1. 此函数的操作，见 GetLocaleInfoEx 函数备注部分。

注意：即使 LCType 参数被指定为 LOCALE_FONTSIGNATURE，cchData 和函数返回仍然是 TCHAR 数。对于该函数的 ANSI 和 Unicode 版本，该数不一样。当应用程序调用一般的 GetLocaleInfoEx 版本，并且指定 LOCALE_FONTSIGNATURE，cchData 可以安全地指定为 sizeof(LOCALESIGNATURE) / sizeof(TCHAR)。

2. 下面的例子展示了非文本值缓冲器大小的直接处理：

int   ret;
CALID calid;
DWORD value;

ret = GetLocaleInfo(LOCALE_USER_DEFAULT,
                    LOCALE_ICALENDARTYPE | LOCALE_RETURN_NUMBER,
                    (LPTSTR)&value,
                    sizeof(value) / sizeof(TCHAR) );
calid = value;

LOCALESIGNATURE LocSig;

ret = GetLocaleInfo(LOCALE_USER_DEFAULT,
                    LOCALE_FONTSIGNATURE,
                    (LPWSTR)&LocSig,
                    sizeof(LocSig) / sizeof(TCHAR) );

3. 该函数的 ANSI 版获取的 ANSI 字符串是从 Unicode 转换成的 ANSI，根据区域标识符的默认 ANSI 编码页。然而，如果指定了 LOCALE_USE_CP_ACP，则转换是基于系统的默认 ANSI 编码页。

4. 当使用该函数的 ANSI 版，并且使用了只能用 Unicode 表示的区域标识符，函数还是能够调用成功，因为操作系统使用的是系统编码页。然而，字符串中在系统编码页中未定义的字符将显示为问号（？）。


需求：