Platform SDK: International Features |
The EnumSystemLocales function enumerates the locales that are either installed on or supported by a system. The dwFlags parameter determines whether the function enumerates installed or supported system locales. The function enumerates locales by passing locale identifiers, one at a time, to the specified application defined–callback function. This continues until all of the installed or supported locale identifiers have been passed to the callback function or the callback function returns FALSE.
BOOL EnumSystemLocales( LOCALE_ENUMPROC lpLocaleEnumProc, // callback function DWORD dwFlags // locales );
Value | Meaning |
---|---|
LCID_INSTALLED | Enumerate only installed locale identifiers. This value cannot be used with LCID_SUPPORTED. |
LCID_SUPPORTED | Enumerate all supported locale identifiers. This value cannot be used with LCID_INSTALLED. |
LCID_ALTERNATE_SORTS | Enumerate only the alternate sorts. If this value is used with either LCID_INSTALLED or LCID_SUPPORTED, then the installed or supported locales will be returned as well as the alternate sort locale IDs. |
If the function succeeds, the return values is a nonzero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError. GetLastError may return one of the following error codes:
The LCID_INSTALLED and LCID_SUPPORTED flags are mutually exclusive.
Windows NT/2000: Requires Windows NT 3.5 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in Winnls.h; include Windows.h.
Library: Use Kernel32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.
National Language Support Overview, National Language Support Functions, EnumLocalesProc