CharUpperA-Funktion (winuser.h)
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 |
Weitere Informationen
Konzept
Referenz