EnumSystemCodePages
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 |
|
); |
|
Parameters
lpCodePageEnumProc
Points to an
application-defined callback function. The EnumSystemCodePages function
enumerates code pages by making repeated calls to this callback function. For
more information, see the EnumCodePagesProc callback function.
dwFlags
Specifies the
code pages to enumerate. This parameter can be one of the following values:
|
Value |
Meaning |
|
CP_INSTALLED |
Enumerate
only installed code pages. |
|
CP_SUPPORTED |
Enumerate
all supported code pages. |
Return Values
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
Remarks
The
CP_INSTALLED and CP_SUPPORTED flags are mutually exclusive.
See Also