CharUpperA-Funktion (winuser.h)

Artikel
08/27/2023

Konvertiert eine Zeichenfolge oder ein einzelnes Zeichen in Großbuchstaben. Wenn es sich bei dem Operanden um eine Zeichenfolge handelt, konvertiert die Funktion die tatsächlichen Zeichen.

Syntax

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

Parameter

[in, out] lpsz

Typ: LPTSTR

Eine NULL-Zeichenfolge oder ein einzelnes Zeichen. Wenn das Wort mit hoher Ordnung dieses Parameters null ist, muss das Wort mit niedriger Ordnung 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 an Ort und Stelle 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 Ordnung null ist, und wort mit niedriger Ordnung das konvertierte Zeichen enthält.

Es gibt keinen Hinweis auf Erfolg oder Misserfolg. Fehler sind selten. Es gibt keine erweiterten Fehlerinformationen für diese Funktion. Rufen Sie GetLastError nicht auf.

Hinweise

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

Hinweis

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


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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll