CharUpperA-Funktion (winuser.h)

Artikel
11/20/2024

Konvertiert eine Zeichenfolge oder ein einzelnes Zeichen in Großbuchstaben. Wenn der Operand eine Zeichenfolge ist, konvertiert die Funktion die Zeichen an Stelle.

Syntax

LPSTR CharUpperA(
  [in, out] LPSTR lpsz
);

Parameter

[in, out] lpsz

Typ: LPTSTR-

Eine mit Null beendete Zeichenfolge oder ein einzelnes Zeichen. Wenn das Hochreihenfolgewort dieses Parameters null ist, muss das Wort mit niedriger Reihenfolge ein einzelnes Zeichen enthalten, das konvertiert werden soll.

Rückgabewert

Typ: LPTSTR-

Wenn der Operand eine Zeichenfolge ist, gibt die Funktion einen Zeiger auf die konvertierte Zeichenfolge zurück. Da die Zeichenfolge direkt konvertiert wird, ist der Rückgabewert gleich lpsz.

Wenn der Operand ein einzelnes Zeichen ist, ist der Rückgabewert ein 32-Bit-Wert, dessen Wort mit hoher Reihenfolge null ist, und das Wort mit niedriger Reihenfolge das konvertierte Zeichen enthält.

Es gibt keine Anzeichen für Erfolg oder Misserfolg. Fehler sind selten. Für diese Funktion gibt es keine erweiterten Fehlerinformationen; rufen Sie GetLastErrornicht auf.

Bemerkungen

Beachten Sie, dass CharUpper immer Kleinbuchstaben I ("i") in Großbuchstaben 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 LCMapStringauf.

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

Anmerkung

Der winuser.h-Header definiert CharUpper als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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