ConvertDefaultLocale
The ConvertDefaultLocale
function converts a special default locale value to an actual locale
identifier.
LCID ConvertDefaultLocale(
|
LCID Locale |
// special default
locale value to be converted |
|
); |
|
Parameters
Locale
A special
default locale value that the function converts to an actual locale identifier.
The following
list shows the special default locale values:
|
Value |
Description |
|
LOCALE_SYSTEM_DEFAULT |
The
system s default locale. |
|
LOCALE_USER_DEFAULT |
The current
user s default locale. |
|
zero |
The
language-neutral default locale. This is equivalent to the locale identifier
created by calling the MAKELCID macro with a language identifier consisting of
the LANG_NEUTRAL and SUBLANG_NEUTRAL values. |
|
Any
sublanguage neutral default locale |
A locale
identifier constructed by calling MAKELCID with a language identifier
consisting of a primary language value, such as LANG_ENGLISH, and the
SUBLANG_NEUTRAL value. |
Return Values
If the
function succeeds, the return value is the appropriate actual locale
identifier.
If the
function fails, the return value is the Locale parameter. The function
fails when Locale is not one of the special default locale values listed
above.
Remarks
A call to ConvertDefaultLocale(LOCALE_SYSTEM_DEFAULT)
is equivalent to a call to GetSystemDefaultLCID. A call to ConvertDefaultLocale(LOCALE_USER_DEFAULT)
is equivalent to a call to GetUserDefaultLCID.
For more
information about locale identifiers, see Locales3QUV0YL and Language Identifiers.
See Also