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).