CharUpperBuffA-Funktion (winuser.h)

Artikel
08/27/2023

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

Syntax

DWORD CharUpperBuffA(
  [in, out] LPSTR 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 Kleinbuchstaben in Großbuchstaben. 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 CharUpperBuff("Zenith of API Sets", 10) erfolgreich ist, ist der Rückgabewert 10.

Hinweise

Beachten Sie, dass CharUpperBuff immer Kleinbuchstaben I ("i") Großbuchstaben 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 LCMapString 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 und Verwenden einer temporären Datei.

Hinweis

Der winuser.h-Header definiert CharUpperBuff 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


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