IsDBCSLeadByteEx

The IsDBCSLeadByteEx function determines whether a character is a lead byte — that is, the first byte of a character in a double-byte character set (DBCS).

BOOL IsDBCSLeadByteEx(
  UINT CodePage,   // identifier of code page
  BYTE TestChar    // character to test
);
 

Parameters

CodePage

Identifier of the code page to use to check lead-byte ranges. Can be one of the code-page values given in the "Code-Page Identifiers" table in Unicode and Character Set Constants or one of the following predefined values:

Value	Meaning
0	Use system default ANSI code page.
CP_ACP	Use system default ANSI code page.
CP_OEMCP	Use system default OEM code page.

TestChar

Character to test.

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.

Remarks

Windows CE: The IsDBCSLeadByteEx function returns the following values:

TRUE

The character is a lead byte.

FALSE

Either the character is not a lead byte, or an error was generated. Call GetLastError for extended error information.

QuickInfo

  Windows NT: Requires version 3.51 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in winnls.h.
  Import Library: Use kernel32.lib.

See Also

Unicode and Character Sets Overview, Unicode and Character Set Functions