GetLocaleInfo函数检索有关区域设置的信息。
int GetLocaleInfo(
LCID 【语言环境】, | //确定地方 |
LCTYPE 【LCType】, | //信息类型 |
LPTSTR 【lpLCData】, | //缓冲区的地址信息 |
INT 【//要绘制的字符串的长度】 | //缓冲区大小 |
); |
参数
【语言环境】
指定检索信息的区域设置。此参数可以是由MAKELCID宏或以下预定义值之一创建的区域设置标识符:
LOCALE_SYSTEM_DEFAULT | 默认系统区域设置。 |
LOCALE_USER_DEFAULT | 默认用户区域设置。 |
【LCType】
指定其中一个LCTYPE常量来指示要检索的信息的类型。
所有LCTYPE值是互斥的,LOCALE_NOUSEROVERRIDE除外。应用程序可以使用二进制或多项运算符将LOCALE_NOUSEROVERRIDE与任何其他LCTYPE值组合。如果通过了【LCType】值,该函数将绕过用户覆盖,并返回所请求的LCID的系统默认值。
【lpLCData】
指向缓冲区以接收所请求的数据。
【//要绘制的字符串的长度】
指定【lpLCData】缓冲区的大小(以字节为单位)(ANSI版本)或字符(Unicode版本)。如果【//要绘制的字符串的长度】为零,则该函数返回保存信息所需的字节数或字符数,不使用【lpLCData】指向的缓冲区。
返回值
如果函数成功,则返回值是写入目标缓冲区的字节数(ANSI版本)或字符(Unicode版本),或者【//要绘制的字符串的长度】参数为零时,保存区域设置所需的字节数或字符数信息。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
ERROR_INSUFFICIENT_BUFFER |
ERROR_INVALID_FLAGS |
ERROR_INVALID_PARAMETER |
备注
GetLocaleInfo函数始终以文本格式检索信息。如果信息是数值,函数将使用十进制符号将数字转换为文本。
也可以看看
GetStringTypeA, GetStringTypeEx, GetStringTypeW, GetSystemDefaultLCID, GetUserDefaultLCID, SetLocaleInfo, MAKELCID