The CharLowerBuff function converts uppercase characters in a buffer to lowercase characters. The function converts the characters in place.
DWORD CharLowerBuff(
LPTSTR lpsz, // pointer to buffer containing characters to
// process
DWORD cchLength // number of bytes or characters to process
);
The function examines each character, and converts uppercase characters to lowercase characters. The function examines the number of bytes or characters indicated by cchLength, even if one or more characters are null characters.
The return value is the number of bytes (ANSI version) or characters (Unicode version) processed. For example, if CharLowerBuff("Acme of Operating Systems", 10) succeeds, the return value is 10.
Windows NT: To make the conversion, the function uses the language driver for the current language selected by the user at setup or by using the Control Panel. If no language has been selected, Windows NT completes the conversion by using internal default mapping. The conversion is made based on the code page associated with the process locale.
Windows 95: The function makes the conversion based on the information associated with the user's default locale, which is the locale selected by the user at setup or by using the Control Panel. Windows 95 does not have language drivers.
Windows CE: Windows CE supports only the Unicode version of this function.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Requires version 1.0 or later.
Header: Declared in winuser.h.
Import Library: Use user32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
String Manipulation Overview, String Manipulation Functions, CharLower, CharUpper, CharUpperBuff