EnumSystemLanguageGroups

The EnumSystemLanguageGroups function enumerates the language groups that are either installed on or supported by a system.

BOOL EnumSystemLanguageGroups(
  LANGUAGEGROUP_ENUMPROC pLangGroupEnumProc, // callback function
  DWORD dwFlags,                             // language groups
  LONG_PTR  lParam                           // callback parameter
);

Parameters

pLangGroupEnumProc

[in] Pointer to an application defined–callback function. For more information, see the EnumLanguageGroupsProc callback function.

dwFlags

[in] Language group identifiers to enumerate. This parameter can be one of the following values.

Value	Meaning
LGRPID_INSTALLED	Enumerate only installed language group identifiers.
LGRPID_SUPPORTED	Enumerate all supported language group identifiers.

lParam

[in] Application-defined value passed to the callback function. This parameter may be used in error checking.

Return Values

If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. To get extended error information, call GetLastError. The GetLastError function may return one of the following error codes:

• ERROR_BADDB
• ERROR_INVALID_PARAMETER
• ERROR_INVALID FLAGS

Remarks

The function enumerates language groups by passing language group identifiers, one at a time, to the specified application defined–callback function. This continues until the last language group identifier is found or the callback function returns FALSE. For more information, see the EnumLanguageGroupsProc callback function.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Winnls.h; include Windows.h.
  Library: Use Kernel32.lib.

See Also

National Language Support Overview, National Language Support Functions, EnumLanguageGroupsProc, IsValidLanguageGroup, EnumLanguageGroupLocales