The EnumSystemCodePages function enumerates the code pages that are either installed on or supported by a system. The dwFlags parameter determines whether the function enumerates installed or supported code pages. The function enumerates the code pages by passing code page identifiers, one at a time, to the specified application-defined callback function. This continues until all of the installed or supported code page identifiers have been passed to the callback function, or the callback function returns FALSE.
BOOL EnumSystemCodePages(
CODEPAGE_ENUMPROC lpCodePageEnumProc, |
// pointer to enumeration callback function |
DWORD dwFlags |
// indicates which code pages to enumerate |
); |
Value |
Meaning |
CP_INSTALLED |
Enumerate only installed code pages. |
CP_SUPPORTED |
Enumerate all supported code pages. |
If the function succeeds, the return value is nonzero.
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:
ERROR_INVALID_PARAMETER
ERROR_BADDB
ERROR_INVALID FLAGS
The CP_INSTALLED and CP_SUPPORTED flags are mutually exclusive.