CharLowerBuff

This function converts uppercase characters in a buffer to lowercase characters. The function converts the characters in place.

At a Glance

Header file: Winbase.h
Windows CE versions: 1.0 and later

Syntax

DWORD CharLowerBuff(LPTSTR lpsz, DWORD cchLength);

Parameters

lpsz

[in] Pointer to a buffer that contains one or more characters to process.

cchLength

[in] Specifies the size, in characters, of the buffer pointed to by lpsz.

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.

Return Values

The number of characters processed indicates success. For example, if CharLowerBuff("Acme of Operating Systems", 10) succeeds, the return value is 10.

Remarks

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 CE does not have language drivers.

Windows CE supports only the Unicode version of this function.

See Also

CharUpperBuff