GetLocaleInfoA
int GetLocaleInfoA(
LCID lcid,
|
|
LCTYPE LCType,
|
|
LPSTR lpLCData,
|
|
int cchData,
|
|
);
|
|
Retrieves locale information from the user's system.
Parameters
-
lcid
-
The locale ID. The returned string is represented in the default ANSI code page for this locale.
-
LCType
-
Flag that indicates the type of information to be returned by the call. See the listing of constant values defined in this chapter. LOCALE_NOUSEROVERRIDE | LCTYPE indicates that the desired information will always be retrieved from the locale database, even if the LCID is the current one and the user has changed some of the values in the Windows 95 Control Panel. If this flag is not specified, the values in Win.ini take precedence over the database settings when getting values for the current system default locale.
-
lpLCData
-
Pointer to the memory where GetLocaleInfoA will return the requested data. This pointer is not referenced if cchData is 0.
-
cchData
-
Character count of the supplied lpLCData memory buffer. If cchData is 0, the return value is the number of characters required to hold the string, including the terminating null character. In this case, lpLCData is not referenced.
Return Value
Value |
Meaning |
0 |
Failure. |
The number of characters copied, including the terminating null character |
Success. |
Comments
GetLocaleInfoA returns one of the various pieces of information about a locale by querying the stored locale database or Win.ini. The call also indicates how much memory is necessary to contain the desired information.
The information returned is always a null-terminated string. No integers are returned by this function and numeric values are returned as text. (See the format descriptions under LCTYPE).