Skip to content

Latest commit

 

History

History
146 lines (108 loc) · 5.24 KB

nf-winnls-enumsystemlanguagegroupsa.md

File metadata and controls

146 lines (108 loc) · 5.24 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winnls.EnumSystemLanguageGroupsA
EnumSystemLanguageGroupsA function (winnls.h)
Enumerates the language groups that are either installed on or supported by an operating system. (ANSI)
EnumSystemLanguageGroupsA
LGRPID_INSTALLED
LGRPID_SUPPORTED
winnls/EnumSystemLanguageGroupsA
intl\enumsystemlanguagegroups.htm
Intl
8cc2335e-b222-44d9-a966-4b6803639071
12/05/2018
EnumSystemLanguageGroups, EnumSystemLanguageGroups function [Internationalization for Windows Applications], EnumSystemLanguageGroupsA, EnumSystemLanguageGroupsW, LGRPID_INSTALLED, LGRPID_SUPPORTED, _win32_EnumSystemLanguageGroups, intl.enumsystemlanguagegroups, winnls/EnumSystemLanguageGroups, winnls/EnumSystemLanguageGroupsA, winnls/EnumSystemLanguageGroupsW
winnls.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
EnumSystemLanguageGroupsW (Unicode) and EnumSystemLanguageGroupsA (ANSI)
Kernel32.lib
Kernel32.dll
Windows
19H1
EnumSystemLanguageGroupsA
winnls/EnumSystemLanguageGroupsA
c++
APIRef
kbSyntax
DllExport
Kernel32.dll
API-MS-Win-Core-Localization-Obsolete-l1-1-0.dll
KernelBase.dll
API-MS-Win-Core-Localization-Obsolete-l1-2-0.dll
API-MS-Win-DownLevel-Kernel32-l1-1-0.dll
MinKernelBase.dll
API-MS-Win-Core-Localization-Obsolete-L1-3-0.dll
API-MS-Win-Core-Localization-Ansi-L1-1-0.dll
Kernel32Legacy.dll
EnumSystemLanguageGroups
EnumSystemLanguageGroupsA
EnumSystemLanguageGroupsW

EnumSystemLanguageGroupsA function

-description

Enumerates the language groups that are either installed on or supported by an operating system.

Note  For custom locales, your application should call EnumSystemLocalesEx instead of EnumSystemLanguageGroups.

 

-parameters

-param lpLanguageGroupEnumProc [in]

Pointer to an application-defined callback function. For more information, see EnumLanguageGroupsProc.

-param dwFlags [in]

Flags specifying the language group identifiers to enumerate. This parameter can have one of the following values.

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

-param lParam [in]

Application-defined value to pass to the callback function. This parameter can be used in error checking. It can also be used to ensure thread safety in the callback function.

-returns

Returns TRUE if successful or FALSE otherwise. To get extended error information, the application can call GetLastError, which can return one of the following error codes:

  • ERROR_BADDB. The function could not access the data. This situation should not normally occur, and typically indicates a bad installation, a disk problem, or the like.
  • ERROR_INVALID_FLAGS. The values supplied for flags were not valid.
  • ERROR_INVALID_PARAMETER. Any of the parameter values was invalid.

-remarks

This function enumerates language groups by passing language group identifiers, one at a time, to the specified application-defined callback function. This process continues until the last language group identifier is found or the callback function returns FALSE.

Note

The winnls.h header defines EnumSystemLanguageGroups as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

National Language Support

National Language Support Functions