CharLowerBuffW-Funktion (winuser.h)

Artikel
11/20/2024

Konvertiert Großbuchstaben in einem Puffer in Kleinbuchstaben. Die Funktion konvertiert die Zeichen an Stelle.

Syntax

DWORD CharLowerBuffW(
  [in, out] LPWSTR lpsz,
  [in]      DWORD  cchLength
);

Parameter

[in, out] lpsz

Typ: LPTSTR-

Ein Puffer, der mindestens ein Zeichen enthält, das verarbeitet werden soll.

[in] cchLength

Typ: DWORD-

Die Größe des Puffers in Zeichen, auf den lpszverweist. Die Funktion untersucht jedes Zeichen und konvertiert Großbuchstaben in Kleinbuchstaben. Die Funktion untersucht die Anzahl der Zeichen, die durch cchLength-angegeben werden, auch wenn mindestens ein Zeichen Nullzeichen sind.

Rückgabewert

Typ: DWORD-

Der Rückgabewert ist die Anzahl der verarbeiteten Zeichen. Wenn beispielsweise CharLowerBuff("Acme of Operating Systems", 10) erfolgreich ist, lautet der Rückgabewert 10.

Bemerkungen

Beachten Sie, dass CharLowerBuff immer Großbuchstaben I in Kleinbuchstaben I ("i") zuordnet, auch wenn die aktuelle Sprache Türkisch oder Aserbaidschan ist. Wenn Sie eine Funktion benötigen, die in dieser Hinsicht sprachlich sensibel ist, rufen Sie LCMapStingauf.

Die Konvertierung in Unicode in der ANSI-Version der Funktion erfolgt in allen Fällen mit dem Systemstandardgebietsschema.

Beispiele

Ein Beispiel finden Sie unter "Erstellen eines Rechtschreibdialogfelds" in Verwenden von Kombinationsfeldern.

Anmerkung

Der winuser.h-Header definiert CharLowerBuff als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll