CPINFOEX
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 specified.
- 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 five. 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.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 98.
Header: Declared in Winnls.h; include Windows.h.
Unicode: Declared as Unicode and ANSI structures.
See Also
National Language Support Overview, National Language Support Structures, GetCPInfoEx, MultiByteToWideChar, WideCharToMultiByte