Prev Next
CPINFOEX info
[This is a preview of an interface that may appear in future releases of
Windows.]
The CPINFOEX structure contains information about a code page. It is
used by the GetCPInfoEx function.
typedef struct _cpinfoex {
UINT MaxCharSize;
BYTE DefaultChar[MAX_DEFAULTCHAR];
BYTE LeadByte[MAX_LEADBYTES];
WCHAR UnicodeDefaultChar;
UINT CodePage;
TCHAR CodePageName[MAX_PATH];
} CPINFOEX *LPCPINFOEX;
Members
-
MaxCharSize
-
Specifies the maximum length, in bytes, of a character in the code page.
-
DefaultChar
-
Specifies the default character used when translating character strings into
this code page. This character is used by the WideCharToMultiByte
function if an explicit default character is not given.
-
LeadByte
-
Specifies a fixed-length array of lead-byte ranges, where the number of
lead-byte ranges is variable. If there are no lead bytes in this code page,
every element of the array is NULL. If there are lead bytes in this code page,
the array contains a starting and ending value for each range. Ranges are
inclusive. The maximum number of lead-byte ranges for any code page is 5. The
array uses 2 bytes to describe each range, with a double-byte null terminator
after the last range.
-
UnicodeDefaultChar
-
Specifies the Unicode default character used in translations from this code
page. This character is used by the MultiByteToWideChar
function.
-
CodePage
-
Specifies the code page value.
-
CodePageName
-
Specifies the full, localized name of the code page.
Remarks
Lead bytes are unique to double-byte character sets (DBCS). A lead byte is the
first byte of a 2-byte character in a DBCS. Lead bytes occupy a specific range
of byte values.
See Also
GetCPInfoEx, MultiByteToWideChar,
WideCharToMultiByte