CharLowerBuffW-Funktion (winuser.h)

Artikel
03/04/2024

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

Syntax

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

Parameter

[in, out] lpsz

Typ: LPTSTR

Ein Puffer mit einem oder mehreren zu verarbeitenden Zeichen.

[in] cchLength

Art: DWORD

Die Größe des Puffers in Zeichen, auf den lpsz verweist. Die Funktion untersucht jedes Zeichen und konvertiert Großbuchstaben in Kleinbuchstaben. Die Funktion untersucht die Anzahl von Zeichen, die von cchLength angegeben werden, auch wenn ein oder mehrere Zeichen NULL-Zeichen sind.

Rückgabewert

Art: DWORD

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

Hinweise

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

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

Beispiele

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

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll