LOCALE_ENUMPROCEX callback function (winnls.h)
An application-defined callback function that processes enumerated locale information provided by the EnumSystemLocalesEx function. The LOCALE_ENUMPROCEX type defines a pointer to this callback function. EnumLocalesProcEx is a placeholder for the application-defined function name.
Syntax
LOCALE_ENUMPROCEX LocaleEnumprocex;
BOOL LocaleEnumprocex(
LPWSTR unnamedParam1,
DWORD unnamedParam2,
LPARAM unnamedParam3
)
{...}
Parameters
unnamedParam1
Pointer to a buffer containing a null-terminated locale name string.
unnamedParam2
Flags defining locale information. Values for this parameter can include a binary OR of flags, but some flag combinations never occur. If the application specifies LOCALE_WINDOWS or LOCALE_ALTERNATE_SORTS, it can also specify LOCALE_REPLACEMENT so that the EnumSystemLocalesEx function can test to see if the locale is a replacement.
- LOCALE_ALL
- LOCALE_ALTERNATE_SORTS; for more information, see EnumSystemLocalesEx
- LOCALE_NEUTRALDATA
- LOCALE_REPLACEMENT This constant is not a valid input to the dwFlags parameter of EnumSystemLocalesEx. To enumerate replacement locales, the application should call this function with the Arg2 parameter specified as LOCALE_WINDOWS or LOCALE_ALL, then check for this constant in the callback function.
- LOCALE_SUPPLEMENTAL
- LOCALE_WINDOWS
- LOCALE_NEUTRALDATA
- LOCALE_SPECIFICDATA
unnamedParam3
An application-provided input parameter of EnumSystemLocalesEx. This value is especially useful for multi-threaded applications, since it can be used to pass thread-specific data to this callback function.
Return value
Returns TRUE to continue enumeration or FALSE otherwise.
Remarks
An EnumLocalesProcEx function can carry out any desired task. The application registers this function by passing its address to the EnumSystemLocalesEx function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | winnls.h |